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1 


Introduction 


The INCA-IP2 communication processor family for LAN phone applications comes with an extensive set of 
software, which was combined to the INCA-IP2 Board Support Package (BSP). It incorporates a wide range of 
applications and protocol stacks, which help to reduce development effort, since software engineers can focus on 
the implementation and integration of additional software while relying on INCA-IP2 BSP’s standard set of protocol 
and application software. 

INCA-IP2 contains two MIPS 24KEc CPUs. One is the main CPU (CPUO), which is supported by a coprocessors 
(CPU1). The coprocessor handles all real time tasks while the main CPU runs the INCA-IP2 BSP software suite 
on top of a Linux® Operating System. The BSP adds drivers for all peripherals integrated in the chip. The modular 
INCA-IP2 BSP structure allows to tailor the software according to any specific scenario and hence optimizing the 
flash memory sizes for a given application. It also allows easy integration of new software components by adding 
them to the source tree of the package and then build them automatically. 

1.1 Scope of the Document 

The scope of this document is to give an overview of all INCA-IP2 BSP components All elements described in this 
document are incorporated in the INCA-IP2 BSP VO. 9. 

1.2 Organization of the Document 

This document is organized as follows: 

• Chapter 1 , Introduction 

Gives a general overview on the contents of the INCA-IP2 Board Support Package and describes the basic 
handling. 

• Chapter 2, Root File System Content 

Gives a general overview on the File System of the Infineon Linux® distribution LXDB-1.0. 

• Chapter 3, Synchronous Serial Channel (SSC) 

Provides a detailed description of the INCA-IP2 Serial Peripheral Interface device driver. This device driver is 
implemented as Linux® kernel module. 

• Chapter 4, Asynchronous Serial Interface (ASC) 

Provides a detailed description of the INCA-IP2 Asynchronous Serial Interface device driver. 

• Chapter 5, Multi Processor System (MPS) 

Provides a detailed description of the INCA-IP2 Multi Processor System device driver. This device driver is 
implemented as Linux® kernel module. 

• Chapter 6, Terminal Specific Functions (TSF) 

Provides a detailed description of the INCA-IP2 Terminal Specific Functions device driver. This device driver is 
implemented as Linux® kernel module. 

• Chapter 7, Ethernet Driver 

Provides a detailed description of the INCA-IP2 Ethernet device driver. 

• Chapter 8, Switch Access Interface 

Provides a detailed description of the INCA-IP2 Switch Access Interface device driver. 

• Chapter 9, Pseudo LAN Driver 

Provides a detailed description of the INCA-IP2 Pseudo LAN device driver. 

• Chapter 10, Crypto Engine Driver 

Provides a detailed description of the INCA-IP2 Crypto Engine device driver. This device driver is implemented as 
Linux® kernel module 
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• Chapter 11, 
Gives a general 

• Chapter 12, 
Gives a general 

• Chapter 13, 
Gives a general 

• Chapter 14, 
Gives a general 

• Chapter 15, 
Gives a general 


USB Support 

overview about the supported USB features. 

Bluetooth Support 

overview about the supported Bluetooth features. 

Multiplexer Support 

overview about the supported Bluetooth features. 

Parallel Port Support 

overview about the supported Bluetooth features. 

TAPI V3.x 

overview about the low level TAPIv3 driver. 


1.3 INCA-IP2 BSP Overview 

Figure 1 gives an architectural overview of all INCA-IP2 BSP components. On the hardware level, the 
coprocessor assist the main CPU in handling the voice based interface. All real time tasks are executed by the 
coprocessor. This concept allows using a non-real time adapted Linux® operating system on the main CPU. 
Hence, using INCA-IP2 BSP, there is no need to allocate software resources for adapting existing protocol stacks 
or applications in order to integrate real time function calls. 

The Linux® OS does not facilitate an internal boot loader. In INCA-IP2 BSP, a boot loader is available that can 
handle kernel images from several sources, like different flash memory types (NOR, NAND). 


Software 
_ _LeveJ_ i 
Hardware 
Level 


Standard Set of Application Software 


Standard Set of Protocol Software 


Device Driver Subsystem 





Main Processor 


Voice Coprocessor 


Peripherals 


BSPARC H ITECTU RE 


Figure 1 INCA-IP2 BSP Architecture 


Once the system has undergone some basic initialization, the boot loader decompresses the Linux® from the flash 
memory, copies it into the SDRAM and jumps to the kernel entry address. From here on, the Linux® OS starts its 
boot procedure. 

Once the Linux® has started, any INCA-IP2 specific device driver might be invoked. The Ethernet driver connects 
to the Linux® socket API and will be automatically addressed when a socket is opened on an Ethernet interface. 
The Multi Processor System (MPS) device driver communicates with the voice coprocessor through a software 
based mailbox. The task of the mailbox is to organize the message based traffic between the voice coprocessors 
and the device driver. The device driver translates Linux® OS function calls to messages for the voice coprocessor 
and vice versa. On the network layer, the INCA-IP2 offers support for a variety of protocol scenarios. 

On top of the protocol related stacks, a set of standard higher layer applications is also included in the INCA-IP2 
BSP. It incorporates an ftp client, a dhcp client, a telnet server and client, the network time protocol and a web 
server. 
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2 Root File System Content 

The target file system for the INCA-IP2 is optimized for minimal size based on uclibc as standard C library. 
Busybox is used as shell and includes some networking functionalities (for example HTTP server and DHCP 
support). 

The next chapters list some directories and describe the most important content. 

2.1 /bin 

This directory contains the busybox binary and a lot of links to busybox which represent standard shell commands. 

2.2 /etc 

Under /etc several configuration files can be found. 

“inittab” will be read by busybox during startup and contains a list of commands, which are run automatically. For 
example the shell is started through inittab. 

“profile” contains definitions for the shell and code which is started everytime the shell is started. 

“rc.conf” is the global config file which should be edited by using the web management or the phone application. 

2.3 /etc/init.d 

Several startup scripts are located in this directory. 

2.4 /firmware 

This directory contains the currently used image of the firmware for the coprocessor. 

2.5 /lib 

Libraries like uclibc are located here. Also kernel modules can be found in the modules directory under the specific 
kernel version. 

2.6 /share/web 

The ASP and HTML files for the web management are located here. 

2.7 /usr/lib 

This directory contains libraries which are used by iptables, PPP and SNMP. 

2.8 /usr/local/lib 

The library for the web management is located in this directory. 

2.9 /usr/local/pa 

This directory contains the IFX SIP phone application. 


'Infineon 


User’s Manual 
Programmer’s Reference 


16 


Revision 1.0, 2006-11-14 



INCA-IP2 

IP-Phone Solution, Linux® BSP Release 2.0 


CONFIDENTIAL 


Synchronous Serial Channel (SSC) 


3 Synchronous Serial Channel (SSC) 


The “ifx_ssc“ module controls the Serial Peripherial Interface SSCO and SSC1 of the INCA-IP2 Standard INCA- 
IP2. 

The availability of the SSCO and/or SSC1 interfaces are requested from the central “mux” module. 

Note: The availability of SSC0/SSC1 interfaces must be defined before compiling the kernel (use “make 
menuconfig”). 

Interface to Kernel Module or User Application 

The two interfaces are mutually exclusive; the instance that applies first “wins”: 

• A kernel module opens an SSC device or 

• An user application opens an SSC device. 

3.1 Proc File /proc/driver/ifx_ssc 

The INCA-IP2 SSC driver registers a proc file, which can be used to query information regarding the state of the 
SSC device. 


Table 1 SSC Driver proc file 


Proc file 

Description 

ifx_ssc 

Prints status information about SSC device 


3.2 Function Reference 

This chapter contains the Function reference. 


Table 2 Function Overview 


Name 

Description 

ifxsscopen 

SSC Port Open. 

ifx_ssc_close 

SSC Port Close. 

ifx_ssc_register_frm_callb 

ack 

Register SSC Frame callback. 

ifxss c_u n reg is te rfrmca 
llback 

Unegister SSC Frame callback. 

ifx_ssc_kread 

SSC kernel read. 

ifx_ssc_kwrite 

SSC kernel write. 

ifxsscread 

SSC Read. 

ifx_ssc_write 

SSC Write. 

ifx_ssc_sethwopts 

SSC set hardware options. 

ifx_ssc_ioctl 

SSC IOCTL. 

ifxssccslow 

Chip select enable. 

ifx_ssc_cs_high 

Chip select disable. 


3.2.1 ifx_ssc_open 


Description 

SSC Port Open. 
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This routine is called whenever a port is opened. It enforces exclusive opening of a port and enables interrupts, etc. 

Prototype 

int ifx_ssc_open ( 

struct inode * inode, 
struct file * filp ) ; 


'Infineon 


Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device or 0/1 for calls from kernel 
mode 

struct file * 

filp 

File pointer of device 


Return Values 


Data Type 

Description 

int 

OOK 


-ENXIO Invalid port number 


-EBUSY Port already open 


3.2.2 ifx_ssc_close 

Description 

SSC Port Close. 

This routine is called when a particular device is closed. 

Prototype 

int ifx_ssc_close ( 

struct inode * inode, 
struct file * filp ) ; 

Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device or 0 or 1 for calls from kernel 

mode 

struct file * 

filp 

File pointer of device 


Return Values 


Data Type 

Description 

int 

OOK 



-ENXIO Invalid port number 
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3.2.3 ifx_ssc_register_frm_callback 

Description 

Register SSC Frame callback. 

This function registers the kernel callback function for the SSC frame end interrupt. 

Prototype 

int ifx_ssc_register_frm_callback ( 
int port, 

void(*) (int port) func ) ; 

Parameters 


'Infineon 


Data Type 

Name 

Description 

int 

port 

SSC Port number (0 = SSCO, 1 = SSC1) 

void(*)(int port) 

func 

Pointer to callback function 


Return Values 


Data Type 

Description 

int 

OOK 

-ENXIO Invalid port number 

-EBUSY A callback function is already registered 

-EINVAL Function Pointer is NULL 


3.2.4 ifx_ssc_unregister_frm_callback 


Description 

Unegister SSC Frame callback. 

This function unregisters the kernel callback function for the SSC frame end interrupt. 

Prototype 

int ifx_ssc_unregister_f rm_callback ( 
int port ) ; 

Parameters 


Data Type 

Name 

Description 

int 

port 

SSC Port number (0 = SSCO, 1 = SSC1) 

Return Values 

Data Type 

Description 

int 

OOK 

-ENXIO Invalid port number 
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3.2.5 ifx_ssc_kread 

Description 

SSC kernel read. 

SSC read function to be called from kernel mode. If called from an interrupt the polling read function will be used. 

If a large number of data shall be received, it is not advised to use this function from interrupts. 

Prototype 

ssize_t ifx_ssc_kread ( 
int port, 
char * kbuf , 
size_t len ) ; 

Parameters 
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Data Type 

Name 

Description 

int 

port 

SSC Port number (0 = SSC0, 1 = SSC1) 

char * 

kbuf 

Pointer to receive buffer 

size_t 

len 

Length of receive buffer 


Return Values 


Data Type 

Description 

ssize_t 

>0 Number of bytes received 


-ENXIO Invalid port number 


-EBUSY Reception currently ongoing 


-EINVAL Invalid receive buffer 


3.2.6 ifxssckwrite 

Description 

SSC kernel write. 

Interface write function to be called from kernel mode. Please note that the buffer will be freed by the transmit 
handler and thus cannot be a local variable but must be allocated with kmalloc. 

Prototype 

ssize_t ifx_ssc_kwrite ( 
int port, 

const char * kbuf, 
size_t len ) ; 


Parameters 


Data Type 

Name 

Description 

int 

port 

SSC Port number (0 = SSC0, 1 = SSC1) 
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Data Type 

Name 

Description 

const char * 

kbuf 

Pointer to receive buffer 

size_t 

len 

Length of receive buffer 


Return Values 


Data Type 

Description 

ssize_t 

>0 Number of bytes received 


-ENXIO Invalid port number 


-EBUSY Transmission currently ongoing 


-EINVAL Invalid receive buffer 


3.2.7 ifx_ssc_read 

Description 

SSC Read. 

This function is called from user space for reading from the SSC. 

Prototype 

ssize_t ifx_ssc_read ( 

struct file * filp, 
char * ubuf , 
size_t len, 
lof f t * Off ) ; 

Parameters 


Data Type 

Name 

Description 

struct file * 

filp 

File structure of device node 

char* 

ubuf 

Buffer to read to 

size_t 

len 

Number of bytes to be read 

loff_t * 

off 

Current position in file 


Return Values 


Data Type 

Description 

ssize_t 

>=0 Number of bytes read from FIFO 
-EBUSY SSC receiver busy 
-ENOMEM Could not allocate Rx buffer 

-EFAULT Transmission failed 


3.2.8 ifx_ssc_write 

Description 

SSC Write. 

This function copies the data from user space into a trasmit buffer and then starts transmission. 
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Prototype 

ssize_t ifx_ssc_write ( 

struct file * filp, 
const char * ubuf, 
size_t len, 
lof f t * Off ) ; 

Parameters 
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Data Type 

Name 

Description 

struct file * 

filp 

File structure of device node 

const char * 

ubuf 

Buffer to read from 

size_t 

len 

Number of bytes to be written 

loff_t * 

off 

Current position in file 


Return Values 


Data Type 

Description 

ssize_t 

>=0 Number of bytes written to FIFO 
-EBUSY SSC transmitter busy 
-ENOMEM Could not allocate Tx buffer 
-EFAULT Transmission failed 


3.2.9 ifx_ssc_sethwopts 

Description 

SSC set hardware options. 

This routine intializes the SSC appropriately depending on slave/master and full-/half-duplex mode. It assumes 
that the SSC is disabled and the fifo's and buffers are flushed later on. 

Prototype 

int ifx_ssc_sethwopts ( 

struct ifx_ssc_port * info ) ; 

Parameters 


Data Type 

Name 

Description 

struct ifx_ssc_port * 

info 

Pointer to structure ifx_ssc_port 


Return Values 


Data Type 

Description 

int 

OOK 

-EINVAL Invalid hardware options supplied 
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3.2.10 ifx_ssc_ioctl 
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Description 

SSC IOCTL. 

The following lOCTIs are supported for the SSC device: 

• I FX_SSC_ST ATS_READ 

• IFX_SSC_STATS_RESET 

• I FX_SSC_B AU D_S ET 

• I FX_SSC_BAU D_GET 

• IFX_SSC_HWOPTS_SET 

• IFX_SSC_HWOPTS_GET 

• IFX_SSC_RXTX_MODE_SET 

• IFX_SSC_RXTX_MODE_GET 

• IFX_SSC_ABORT 

• IFX_SSC_FIFO_FLUSH 

• I FX_SSC_G POO UT_SET 

• IFX_SSC_GPO_OUT_CLR 

• IFX_SSC_GPO_OUT_GET 

• IFX_SSC_FRM_STATUS_GET 

• IFX_SSC_FRM_CONTROL_GET 

• IFX_SSC_FRM_CONTROL_SET 

• IFX_SSC_DMA_ENABLE 

• IFX_SSC_DMA_DISABLE 

• IFX_SSCJ3UFFER_FREE_ENABLE 

• IFX_SSCJ3UFFER_FREE_DISABLE 


Prototype 

int ifx_ssc_ioctl ( 

struct inode * inode, 
struct file * filp, 
unsigned int cmd, 
unsigned long data ) ; 


Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device 

struct file * 

filp 

File structure of device 

unsigned int 

cmd 

IOCTL command 

unsigned long 

data 

Argument for some IOCTL commands 


Return Values 


Data Type 

Description 

int 

-ENOIOCTLCMD invalid IOCTL command 
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3.2.11 ifx_ssc_cs_low 

Description 

Chip select enable. 

This function sets the given chip select for SSCO to low. 

Prototype 

ifx_void_t ifx_ssc_cs_low ( 
u32 pin ) ; 

Parameters 
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Data Type 

Name 

Description 

u32 

pin 

Selected CS pin 


3.2.12 ifx_ssc_cs_high 


Description 

Chip select disable. 

This function sets the given chip select for SSCO to high. 

Prototype 

ifx_void_t ifx_ssc_cs_high ( 
u32 pin ) ; 

Parameters 


Data Type 

Name 

Description 

u32 

pin 

Selected CS pin 


3.3 IOCTL Reference 

This chapter contains the IOCTL reference. 


Table 3 DefineOverview 


Name 

Description 

IFX_SSC_STATS_READ 

Read out the statistics. 

IFX_SSC_STATS_RESET 

Clear the statistics. 

IFXSSCBAUDSET 

Set the baudrate. 

IFXSSCBAUDGET 

Get the current baudrate. 

IFX_SSC_HWOPTS_SET 

Set hardware options. 

IFXSSCHWO PTSGET 

Get the current hardware options. 

IFXSSCRXTXMODESE 

T 

Set transmission mode. 

IFXSSCRXTXMODEG 

ET 

Get the current transmission mode. 
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Table 3 DefineOverview (cont’d) 


Name 

Description 

IFXSSCABORT 

Abort transmission. 

IFX_SSC_FIFO_FLUSH 

Set general purpose outputs. 

IFXSSCGPOOUTSET 

Set general purpose outputs. 

IFXSSCGPOOUTCLR 

Clear general purpose outputs. 

IFXSSCG POOUTG ET 

Get general purpose outputs. 

IFXSSCFRMSTATUSG 

ET 

Get status of serial framing. 

IFXSSCFRMCONTROL 

_GET 

Get counter reload values and control bits. 

IFXSSCFRMCONTROL 

_SET 

Set counter reload values and control bits. 

IFXSSCDMAENABLE 

Enable DMA for SSC. 

IFXSSCDMADISABLE 

Disable DMA for SSC. 

IFX_SSC_RESURRECT 

Free txbuf and rxbuf. 

IFX_SSC_BUFFER_FREE_ 

ENABLE 

Enable freeing of buffers for all SSCs. 

IFX_SSC_BUFFER_FREE_ 

DISABLE 

Disable freeing of buffers for all SSCs. 


3.3.1 IFX_SSC_STATS_READ 


Prototype 

#def ine IFX_SSC_STATS_READ _IOR(IFX_SSC_IOCTL_MAGIC, l f struct ifx_ssc_statistics ) 

Parameters 
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Data Type 

Name 

Description 

1 FX_SSC_STATS_READ 

_IOR(IFX_SSC_IOCTL_MAGI 
C, 1 , struct ifx_ssc_statistics) 

Read out the statistics. 


3.3.2 IFX_SSC_STATS_RESET 
Prototype 

ttdefine IFX_SSC_STATS_RESET _IO ( IFX_SSC_IOCTL_MAGIC , 2) 

Parameters 


Data Type 

Name 

Description 

1 FX_SSC_STATS_RESET 

IO(IFX SSC IOCTL MAGIC 
,2) 

Clear the statistics. 
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3.3.3 I FX SS C_B AU D_S ET 

Prototype 

ttdefine IFX_SSC_BAUD_SET _IOW ( IFX_SSC_IOCTL_MAGIC , 3, unsigned int) 

Parameters 


Data Type 

Name 

Description 

1 FX_SSC_BAU D_SET 

_l OW( 1 FX_SSC_I OCTL_MAG 
1C, 3, unsigned int) 

Set the baud rate. 


3.3.4 I FX SS C_B AU D_G ET 
Prototype 

ttdefine IFX_SSC_BAUD_GET _IOR ( IFX_SSC_IOCTL_MAGIC , 4, unsigned int) 


Parameters 


Data Type 

Name 

Description 

IFX_SSC_BAUD_GET 

_IOR(IFX_SSC_IOCTL_MAGI 
C, 4, unsigned int) 

Get the current baudrate. 


3.3.5 IFX_SSC_HWOPTS_SET 
Prototype 

#def ine IFX_SSC_HWOPTS_SET _I0W ( IFX_SSC_IOCTL_MAGIC , 5, struct ifx_ssc_hwopts ) 

Parameters 
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Data Type 

Name 

Description 

1 FX_SSC_HWO PTS_SET 

_IOW(IFX_SSCJOCTL_MAG 
1C, 5, struct ifx_ssc_hwopts) 

Set hardware options. 


3.3.6 IFX_SSC_HWOPTS_GET 
Prototype 

#def ine IFX_SSC_HWOPTS_GET _IOR(IFX_SSC_IOCTL_MAGIC, 6, struct ifx_ssc_hwopts ) 

Parameters 


Data Type 

Name 

Description 

IFX_SSC_HWOPTS_GET 

_IOR(IFX_SSC_IOCTL_MAGI 
C, 6, struct ifx_ssc_hwopts) 

Get the current hardware options. 
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3.3.7 IFXSSCRXTXMODESET 

Prototype 

ttdefine IFX_SSC_RXTX_MODE_SET _IOW ( IFX_SSC_IOCTL_MAGIC , 7, unsigned int) 

Parameters 


Data Type 

Name 

Description 

IFX SSC RXTX MODE SET 

IOW(IFX SSC IOCTL MAG 
1C, 7, unsigned int) 

Set transmission mode. 


3.3.8 IFX_SSC_RXTX_MODE_GET 
Prototype 

ttdefine IFX_SSC_RXTX_MODE_GET _IOR ( IFX_SSC_IOCTL_MAGIC , 8, unsigned int) 


Parameters 


Data Type 

Name 

Description 

IFX_SSC_RXTX_MODE_GET 

IOR(l FX_SSC_IOCTL_M AG 1 

C, 8, unsigned int) 

Get the current transmission mode. 


3.3.9 IFXSSCABORT 
Prototype 

#def ine IFX_SSC_ABORT _I0 (IFX_SSC_IOCTL_MAGIC, 9) 

Parameters 
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Data Type 

Name 

Description 

1 FX_SSC_ABORT 

IO(IFX SSC IOCTL MAGIC 
.9) 

Abort transmission. 

3.3.10 IFX_SSC_FIFO 

_FLUSH 


Prototype 

#def ine IFX_SSC_FIFO_FLUSH _IO ( IFX_SSC_IOCTL_MAGIC , 10) 

Parameters 



Data Type 

Name 

Description 

IFX_SSC_FIFO_FLUSH 

IO(IFX SSC IOCTL MAGIC 
.10) 

Set general purpose outputs. 
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3.3.11 IFX_SSC_GPO_OUT_SET 

Prototype 

ttdefine IFX_SSC_GPO_OUT_SET _IOW ( IFX_SSC_IOCTL_MAGIC , 11, unsigned int) 

Parameters 


Data Type 

Name 

Description 

IFX_SSC_GPO_OUT_SET 

_l OW( 1 FX_SSC_IOCTL_MAG 
1C, 11, unsigned int) 

Set general purpose outputs. 


3.3.12 IFX_SSC_GPO_OUT_CLR 
Prototype 

ttdefine IFX_SSC_GPO_OUT_CLR _IOW ( IFX_SSC_IOCTL_MAGIC , 12, unsigned int) 


Parameters 
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Data Type 

Name 

Description 

IFX_SSC_GPO_OUT_CLR 

_l OW( 1 FX_SSC_IOCTL_MAG 
1C, 12, unsigned int) 

Clear general purpose outputs. 

3.3.13 IFXSSCGPO 

Prototype 

#def ine IFX_SSC_GPO_OUT_ 

Parameters 

_OUT_GET 

.GET _IOR(IFX_SSC_IOCTL_MAGIC, 13, unsigned int) 

Data Type 

Name 

Description 

1 FX_SSC_G POOUTG ET 

_l OR( 1 FX_SSC_I OCTL_M AG 1 
C, 13, unsigned int) 

Get general purpose outputs. 


3.3.14 IFX_SSC_FRM_STATUS_GET 
Prototype 

#def ine IFX_SSC_FRM_STATUS_GET _I0R ( IFX_SSC_IOCTL_MAGIC , 14, struct 
ifx_ssc_frm_status) 

Parameters 


Data Type 

Name 

Description 

IFX SSC FRM STATUS GE 

T 

IOR(IFX SSC IOCTL MAGI 
C, 14, struct 
ifx_ssc_frm_status) 

Get status of serial framing. 
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3.3.15 IFXSSCFRMCONTROLGET 

Prototype 

ttdefine IFX_SSC_FRM_CONTROL_GET _IOR ( IFX_SSC_IOCTL_MAGIC , 15, struct 
ifx_ssc_frm_opts) 

Parameters 


Data Type 

Name 

Description 

IFX_SSC_FRM_CONTROL_G 

ET 

_IOR(IFX_SSC_IOCTL_MAGI 
C, 15, struct ifx_ssc_frm_opts) 

Get counter reload values and control bits. 

3.3.16 IFX_SSC_FRM 

CONTROLSET 



Prototype 

ttdefine IFX_SSC_FRM_CONTROL_SET _IOW ( IFX_SSC_IOCTL_MAGIC , 16, struct 
ifx_ssc_frm_opts) 


Parameters 


Data Type 

Name 

Description 

IFX_SSC_FRM_CONTROL_S 

ET 

_IOW(IFX_SSC_IOCTL_MAG 
1C, 16, struct ifx_ssc_frm_opts) 

Set counter reload values and control bits. 

3.3.17 IFXSSCDMA 

ENABLE 



Prototype 

#def ine I FX_S SC_DMA_ENABLE _IO ( IFX_SSC_IOCTL_MAGIC , 17) 

Parameters 
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Data Type 

Name 

Description 

IFX_SSC_DMA_ENABLE 

IO(IFX SSC IOCTL MAGIC 
,17) 

Enable DMA for SSC. 


3.3.18 IFX_SSC_DMA_DISABLE 
Prototype 

#def ine IFX_SSC_DMA_DISABLE _IO (IFX_SSC_IOCTL_MAGIC, 18) 

Parameters 


Data Type 

Name 

Description 

IFX_SSC_DMA_DISABLE 

IO(IFX SSC IOCTL MAGIC 
,18) 

Disable DMA for SSC. 
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3.3.19 IFX_SSC_RESURRECT 

Prototype 

ttdefine IFX_SSC_RESURRECT _IO ( IFX_SSC_IOCTL_MAGIC , 19) 

Parameters 
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Data Type 

Name 

Description 

IFX_SSC_RESURRECT 

IO(IFX SSC IOCTL MAGIC 
.19) 

Free txbuf and rxbuf. 


3.3.20 IFX_SSC_BUFFER_FREE_ENABLE 
Prototype 

ttdefine IFX_SSC_BUFFER_FREE_ENABLE _IO ( IFX_SSC_IOCTL_MAGIC , 20) 

Parameters 


Data Type 

Name 

Description 

IFX_SSC_BUFFER_FREE_E 

NABLE 

_IO(IFX_SSC_IOCTL_MAGIC 
, 20) 

Enable freeing of buffers for all SSCs. 


3.3.21 IFX_SSC_BUFFER_FREE_DISABLE 
Prototype 

#def ine I FX_S SC_BUFFER_FREE_DI SABLE _IO ( IFX_SSC_IOCTL_MAGIC , 21) 

Parameters 


Data Type 

Name 

Description 

IFX_SSC_BUFFER_FREE_DI 

SABLE 

IO(IFX SSC IOCTL MAGIC 
.21) 

Disable freeing of buffers for all SSCs. 
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4 Asynchronous Serial Interface (ASC) 


The INCA-IP2 features two asynchronous serial interfaces (ASCO and ASCI). Both can be accessed under Linux 
via terminal devices /dev/ttySO and /dev/ttySI . The driver is compiled directly into the kernel and ASCO is activated 
as console during boot. All messages will be printed to this device until another logging mechanism is started (for 
example syslogd). 

The standard setting for the console is: 

115200 Baud, 8 Databits, No parity, 1 Stopbit 

The baudrate is set by a kernel parameter from the boot loader. With the stty program it is possible to change 
terminal settings during runtime. It can also be used to query th ecurrent setting of the interface. 

# stty speed 

will print the current baudrate. To change the baudrate to 9600 the following command would be used: 

# stty speed 9600 

Note: After changing the terminal settings, the used terminal program must also be adjusted to the same settings. 
Otherwise it will not react on any input. 

By default stty uses /dev/ttySO as device. This behavior can be changed with the -F option. 

# stty -F /dev/ttySI 38400 

will change the baudrate of ASCI to 38400. 
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5 Multi Processor System (MPS) 


This chapter describes the software interface and implementation of the device driver for the voice processor. 
The interface between the INCA-IP2 main processor and the voice coprocessor is implemented through a 
software mailbox mechanism. The communication between voice coprocessor and main processor is based on 
transmitting specific command messages / voice packets through this mailbox. 

The voice coprocessor driver encapsulates support for the following main packet types: 

• Voice packets (Read/Write) for real-time voice streaming, 

• Command packets (Read/Write) for realizing various DSP functionalities, 

• Firmware download. 

5.1 Internal Structure 

The flow of messages to the mailboxes are handled by internal FIFOs. The size of the internal FIFOs is configured 
during compilation of the source code and cannot be changed during runtime. 

The following communication paths are handled by the FIFOs: 

• Voice channel 0 downstream / upstream, 

• Voice channel 1 downstream / upstream, 

• Voice channel 2 downstream / upstream, 

• Voice channel 3 downstream / upstream, 

• Command connection upstream / downstream. 
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MPS_data_flow 

Figure 2 Internal Communication Structure in the MPS Device Driver 

5.2 Driver Module 

The driver module is called mps.o and can be inserted using insmod. 

5.3 Proc Files in /proc/driver/ifx-mps 

The INCA-IP2 MPS driver provides access to status information using proc files located in /proc/driver/ifx-mps/. 
The following entries are provided: 


Table 4 MPS Driver proc files 


Proc file 

Description 

version 

Display MPS driver version information 

status 

Display MPS specific status information 


5.4 Function Reference 

This chapter contains the Function reference. 
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Table 5 Function Overview 


Name 

Description 

ifxmpsopen 

Open MPS device. 

ifx_mps_close 

Close MPS device. 

ifx_mps_poll 

Poll handler. 

ifxmpsioctl 

MPS IOCTL handler. 

ifx_mps_register_data_call 

back 

Register data callback. 

ifx_m ps_u n re g iste r_d ata_ 
callback 

Unregister data callback. 

ifxm psre g iste r e ve n t_ca 
llback 

Register event callback. 

ifx_mps_unregister_event 

callback 

Unregister event callback. 

ifxmpseventactivation 

Change event interrupt activation. 

ifxm psreadm a i 1 box 

Read from mailbox upstream FIFO. 

ifx_mps_write_mailbox 

Write to downstream mailbox buffer. 


5.4.1 ifx_mps_open 

Description 

Open MPS device. 

Open the device from user mode (e.g. application) or kernel mode. An inode value of 1 ..5 indicates a kernel mode 
access. In such a case the inode value is used as minor ID. 

Prototype 

s32 ifx_mps_open ( 

struct inode * inode, 
struct file * file_p ) ; 

Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

Pointer to device inode 

struct file * 

file_p 

Pointer to file descriptor 


Return Values 


Data Type 

Description 

s32 

0 OK, device opened 


EMFILE Device already open 


EINVAL Invalid minor ID 
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5.4.2 ifx_mps_close 

Description 

Close MPS device. 

Close the device from user mode (e.g. application) or kernel mode. An inode value of 1 ..5 indicates a kernel mode 
access. In such a case the inode value is used as minor ID. 

Prototype 

s32 ifx_mps_close ( 

struct inode * inode, 
struct file * filp ) ; 

Parameters 
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Data Type 

Name 

Description 

struct inode * 

inode 

Pointer to device inode 

struct file * 

filp 

Pointer to file descriptor 


Return Values 


Data Type 

Description 

s32 

0 OK, device closed 


ENODEV Device invalid 


EINVAL Invalid minor ID 


5.4.3 ifx_mps_poll 

Description 

Poll handler. 

The select function of the driver. A user space program may sleep until the driver wakes it up. 

Prototype 

unsigned int ifx_mps_poll ( 
struct file * file_p, 
poll_table * wait ) ; 

Parameters 


Data Type 

Name 

Description 

struct file * 

filep 

File structure of device 

poll table * 

wait 

Internal table of poll wait queues 
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Return Values 


Data Type 

Description 

unsigned int 

mask If new data is available the POLLPRI bit is set, triggering an exception indication. 

If the device pointer is null POLLERR is set. 


5.4.4 ifx _mps_ioctl 

Description 

MPS IOCTL handler. 

An inode value of 1..5 indicates a kernel mode access. In such a case the inode value is used as minor ID. The 
following lOCTLs are supported for the MPS device. 

• FIO_MPS_EVENT_REG 

• FIO_MPS_EVENT_UNREG 

• FIO_MPS_MB_READ 

• FIO_MPS_MB_WRITE 

• FIO_MPS_DOWNLOAD 

• FIO_MPS_GETVERSION 

• FIO_MPS_MB_RST_QUEUE 

• FIO_MPS_RESET 

• FIO_MPS_RESTART 

• F 1 0_M PS_G ET_ST ATU S 

If MPS_FIFO_BLOCKING_WRITE is defined the following commands are also available. 

• F 1 0_M PS_TXF I FO_SET 

• FIO_MPS_TXFIFO_GET 

Prototype 

s32 ifx_mps_ioctl ( 

struct inode * inode, 
struct file * file_p, 
u32 nCmd, 

unsigned long arg ) ; 


Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device 

struct file * 

filep 

File structure of device 

u32 

nCmd 

IOCTL command 

unsigned long 

arg 

Argument for some IOCTL commands 


Return Values 


Data Type 

Description 

s32 

0 Setting the LED bits was successful! 

-EINVAL Invalid minor ID 
-ENOIOCTLCMD Invalid command 


User’s Manual 
Programmer’s Reference 


36 


Revision 1.0, 2006-11-14 


INCA-IP2 

IP-Phone Solution, Linux® BSP Release 2.0 


CONFIDENTIAL Multi Processor System (MPS) 

5.4.5 ifx_mps_register_data_callback 

Description 

Register data callback. 

Allows the upper layer to register a callback function either for downstream (tranmsit mailbox space available) or 
for upstream (read data available) 

Prototype 

s32 ifx_mps_register_data_callback ( 
type, 
u32 dir, 

void(*) ( type) callback ); 

Parameters 
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Data Type 

Name 

Description 


type 

DSP device entity ( 1 - command, 2 - voiceO, 3 
- voice 1 , 4 - voice2, 5 - voice3 ) 

u32 

dir 

Direction (1 - upstream, 2 - downstream) 

void(*)( type) 

callback 

Callback function to register 


Return Values 


Data Type 

Description 

s32 

0 OK, callback registered successfully 

ENXIO Wrong DSP device entity (only 1-5 supported) 

EBUSY Callback already registered 

EINVAL Callback parameter null 


5.4.6 ifx_mps_unregister_data_callback 

Description 

Unregister data callback. 

Allows the upper layer to unregister the callback function previously registered. 

Prototype 

s32 ifx_mps_unregister_data_callback ( 
type, 

u32 dir ) ; 

Parameters 


Data Type 

Name 

Description 


type 

DSP device entity ( 1 - command, 2 - voiceO, 3 
- voice 1 , 4 - voice2, 5 - voice3 ) 

u32 

dir 

Direction (1 - upstream, 2 - downstream) 
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Return Values 


Data Type 

Description 

s32 

0 OK, callback registered successfully 

ENXIO Wrong DSP device entity (only 1-5 supported) 

EINVAL Nothing to unregister 

EINVAL Callback value null 


5.4.7 ifx _mps_register_event_callback 

Description 

Register event callback. 

Allows the upper layer to register a callback function either for events specified by the mask parameter. 

Prototype 

s32 ifx_mps_register_event_callback ( 
type, 

MbxEventRegs_s * mask, 

void(*) (MbxEventRegs_s *events) callback ) ,- 

Parameters 


Data Type 

Name 

Description 


type 

DSP device entity ( 1 - command, 2 - voiceO, 3 
- voice 1 , 4 - voice2, 5 - voice3 ) 

MbxEventRegs_s * 

mask 

Mask according to MBCJSR content 

void(*)(MbxEventRegs_s 

‘events) 

callback 

Callback function to register 


Return Values 


Data Type 

Description 

s32 

0 OK, callback registered successfully 

ENXIO Wrong DSP device entity (only 1-5 supported) 

EBUSY Callback already registered 


5.4.8 ifx_mps_unregister_event_callback 


Description 

Unregister event callback. 

Allows the upper layer to unregister the callback function previously registered. 

Prototype 

s32 ifx_mps_unregister_event_callback ( 
type ) ; 
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Parameters 



Data Type 

Name 

Description 


type 

DSP device entity ( 1 - command, 2 - voiceO, 3 
- voice 1 , 4 - voice2, 5 - voice3 ) 


Return Values 


Data Type 

Description 

s32 

0 OK, callback registered successfully 

ENXIO Wrong DSP device entity (only 1-5 supported) 


5.4.9 ifx mps event activation 

Description 

Change event interrupt activation. 

Allows the upper layer enable or disable interrupt generation of event previously registered. Note that 

Prototype 

s32 ifx_mps_event_activation ( 
type, 

MbxEventRegs_s * act ) ; 

Parameters 


Data Type 

Name 

Description 


type 

DSP device entity ( 1 - command, 2 - voiceO, 3 
- voice 1 , 4 - voice2, 5 - voice3 ) 

MbxEventRegs_s * 

act 

Register values according to MbxEvent_Regs, 
whereas bit=1 means active, bit=0 means 
inactive 


Return Values 


Data Type 

Description 

s32 

0 OK, interrupt masked changed accordingly 

ENXIO Wrong DSP device entity (only 1-5 supported) 

EINVAL Callback value null 


5.4.10 ifx _mps_read_mailbox 


Description 

Read from mailbox upstream FIFO. 

This function reads from the mailbox upstream FIFO selected by type. 
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Prototype 

s32 ifx_mps_read_mailbox ( 
type, 

mps_message * rw ) ; 

Parameters 
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Data Type 

Name 

Description 


type 

DSP device entity ( 1 - command, 2 - voiceO, 3 
- voice 1 , 4 - voice2, 5 - voice3 ) 

mps_message * 

rw 

Pointer to message structure for received data 


Return Values 


Data Type 

Description 

s32 

0 OK, successful read operation 

ENXIO Wrong DSP device entity (only 1-5 supported) 

-1 ERROR, in case of read error. 


5.4.11 ifx _mps_write_mailbox 

Description 

Write to downstream mailbox buffer. 

This function writes data to either the command or to the voice FIFO 

Prototype 

s32 ifx_mps_write_mailbox ( 
type, 

mps_message * rw ) ; 

Parameters 


Data Type 

Name 

Description 


type 

DSP device entity ( 1 - command, 2 - voiceO, 3 
- voice 1 , 4 - voice2, 5 - voice3 ) 

mps_message * 

rw 

Pointer to message structure 


Return Values 


Data Type 

Description 

s32 

0 OK, successful write operation 

-ENXIO Wrong DSP device entity (only 1-5 supported) 

-EAGAIN ERROR, in case of FIFO overflow. 


5.5 IOCTL Reference 

This chapter contains the IOCTL reference. 
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Table 6 DefineOverview 


Name 

Description 

FIOMPSEVENTREG 

Set event notification mask. 

FIO_MPS_EVENT_UNREG 

Mask Event Notification. 

FIO_MPS_MB_READ 

Read Message from Mailbox. 

FIOMPSMBWRITE 

Write Message to Mailbox. 

FIO_MPS_RESET 

Reset Voice CPU. 

FIO_MPS_RESET 

Restart Voice CPU. 

FIOMPSGETVERSION 

Read Version String. 

FIOMPSMBRSTQUEU 

E 

Reset Mailbox Queue. 

FIO_MPS_DOWNLOAD 

Download Firmware. 

FIOMPSTXFIFOSET 

Set FIFO Blocking State. 

FIOMPSTXFIFOGET 

Read FIFO Blocking State. 

FIO_MPS_GET_STATUS 

Read channel Status Register. 

FIO_MPS_GET_CMD_HIST 

ORY 

Read command history buffer. 


5.5.1 FIO_MPS_EVENT_REG 


Prototype 

#def ine F I 0_MP S_EVENT_REG _IOW ( IFX_MPS_MAGIC , 1, unsigned int) 

Parameters 


Data Type 

Name 

Description 

FIO_MPS_EVENT_REG 

_l OW( 1 FXMPSMAG 1 C , 1 , 
unsigned int) 

Set event notification mask. 


5.5.2 FIO_MPS_EVENT_UNREG 
Prototype 

#def ine FIO_MPS_EVENT_UNREG _IO ( IFX_MPS_MAGIC , 2) 

Parameters 


Data Type 

Name 

Description 

FIOMPSEVENTUNREG 

10(1 FX_M PS_M AG 1 C , 2) 

Mask Event Notification. 


5.5.3 FIO_MPS_MB_READ 
Prototype 

#def ine F I 0_MP S_MB_RE AD _IOR ( IFX_MPS_MAGIC , 3, mps_message) 
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Parameters 



Data Type 

Name 

Description 

FIO_MPS_MB_READ 

_IOR(IFX_MPS_MAGIC, 3, 
mps_message) 

Read Message from Mailbox. 


5.5.4 


FIOMPSMBWRITE 


Prototype 

#def ine FIO_MPS_MB_WRITE _IOW(IFX_MPS_MAGIC, 4, mps_message) 


Data Type 

Name 

Description 

FIO_MPS_MB_WRITE 

_IOW(IFX_MPS_MAGIC, 4, 
mps_message) 

Write Message to Mailbox. 


5.5.5 FIOMPSRESET 
Prototype 

#def ine FIO_MPS_RESET _IO (IFX_MPS_MAGIC, 6) 

Parameters 


Data Type 

Name 

Description 

FIO_MPS_RESET 

10(1 FX_M PS_M AG 1 C , 6) 

Reset Voice CPU. 

5.5.6 FIO_MPS_RESTART 


Prototype 

#def ine FIO_MPS_RESTART 

_IO ( IFX_MPS_MAGIC , 7) 


Parameters 



Data Type 

Name 

Description 

FIO_MPS_RESTART 

10(1 FX_M PS_M AG 1 C , 7) 

Restart Voice CPU. 


5.5.7 FIO_MPS_GETVERSION 
Prototype 

#def ine FIO_MPS_GETVERSION _IOR(IFX_MPS_MAGIC, 8, char*) 
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Parameters 



Data Type 

Name 

Description 

FIO_MPS_GETVERSION 

_l OR( 1 FX_M PS_M AG 1 C , 8, 
char*) 

Read Version String. 

5.5.8 FIO_MPS_MB_RST_QUEUE 

Prototype 

#def ine FIO_MPS_MB_RST_QUEUE _IO ( IFX_MPS_MAGIC , 

Parameters 

9) 

Data Type 

Name 

Description 

F 1 0_M PS_M BRSTQ U E U E 

10(1 FX_M PS_M AG 1 C , 9) 

Reset Mailbox Queue. 


5.5.9 FIOMPSDOWNLOAD 


Prototype 

#def ine FIO_MPS_DOWNLOAD _IO ( IFX_MPS_MAGIC , 17) 


Data Type 

Name 

Description 

F 1 OMPSDOWN LOAD 

_IO(IFX_MPS_MAGIC, 17) 

Download Firmware. 


5.5.10 FIOMPSTXFIFOSET 
Prototype 

#def ine FIO_MPS_TXFIFO_SET _IOW(IFX_MPS_MAGIC, 18, bool_t) 

Parameters 


Data Type 

Name 

Description 

FIO_MPS_TXFIFO_SET 

_IOW(IFX_MPS_MAGIC, 18, 
bool_t) 

Set FIFO Blocking State. 


5.5.11 FIO_MPS_TXFIFO_GET 
Prototype 

#def ine FIO_MPS_TXFIFO_GET _IOR(IFX_MPS_MAGIC, 19, bool_t) 
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Parameters 



Data Type 

Name 

Description 

F 1 0_M PS_TXF 1 F 0_G ET 

_l OR(l FX_M PS_MAG 1 C , 19, 
bool_t) 

Read FIFO Blocking State. 


5.5.12 FIO_MPS_GET_STATUS 


Prototype 

#def ine FIO_MPS_GET_STATUS _IOR(IFX_MPS_MAGIC, 20, u32) 

Parameters 


Data Type 

Name 

Description 

F 1 0_MPS_G ET_STATU S 

_l OR(l FX_M PS_MAG 1 C , 20, 
u32) 

Read channel Status Register. 

5.5.13 FIO_MPS_GET_CMD_HISTORY 


Prototype 

#def ine FIO_MPS_GET_CMD_ 

.HISTORY _IOR ( IFX_MPS_MAGIC , 21, u32) 

Parameters 



Data Type 

Name 

Description 

F 1 0_M P S_G ET_C M D_H 1 STO 
RY 

_l O R( 1 FX_M PS_M AG 1 C , 21, 
u32) 

Read command history buffer. 
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6 Terminal Specific Functions (TSF) 

The Terminal Specific Functions (TSF) comprises the keypad scanner, the LED multiplex unit and the pulse width 
modulation units. All three functionalities are grouped in a single kernel module (tsf) 

6.1 Keypad Scanner 

The “tsf’ kernel module serves interrupts origined from the keypad scanner over pins KEY0..14 
The KEYO-6 pins are always available, allowing to control up to 21 keys. 

Pins KEY7-14 are multiplexed with GPIO, SPI or ASC pins. The “tsf’ module queries the number of available KEY 
pins from the mux module. 

With pins KEYO-7, up to 28 keys can be realized. 

With pins KEYO-8, up to 36 keys can be realized. 

With pins KEYO-9, up to 45 keys can be realized. 

With pins KEY0-10, up to 55 keys can be realized. 

With pins KEY0-11, up to 66 keys can be realized. 

With pins KEYO-12, up to 78 keys can be realized. 

With pins KEYO-13, up to 91 keys can be realized. 

With pins KEY0-14, up to 105 keys can be realized. 

Note: The pins that shall be assigned to the keypad scanner must be defined before compiling the kernel (use 
“make menuconfig”). 

A “keypad” device is registered to give user space applications access to the keypad scanner. 

Key Event Reporting 

The keypad module contains a ring buffer storing KEY PRESSED / KEY RELEASED events. For optionally 
determining the duration of pressing a key down, the timestamp “jiffies” is added to each key event. 

Key Code 

The key code is determined according to the scanline -> keycode mapping examples given in Table 7 and 
Table 8. 


Table 7 Example: Keycodes for KEY(y,x) = RESyx with 14 Scanlines 


y 

x 

RES1 

2x 

RES1 

lx 

RES1 

Ox 

RES9 

x 

RES8 

x 

RES7 

x 

RES6 

x 

RES5 

x 

RES4 

x 

RES3 

x 

RES2 

x 

RES1 

X 

RES0 

x 

13 

5A 

59 

57 

54 

50 

4B 

45 

3E 

36 

2D 

23 

18 

C 

12 


58 

56 

53 

4F 

4A 

44 

3D 

35 

2C 

22 

17 

B 

11 



55 

52 

4E 

49 

43 

3C 

34 

2B 

21 

16 

A 

10 

Case 3 



51 

4D 

48 

42 

3B 

33 

2A 

20 

15 

9 

9 





4C 

47 

41 

3A 

32 

29 

IF 

14 

8 

8 






46 

40 

39 

31 

28 

IE 

13 

7 

7 







3F 

38 

30 

27 

ID 

12 

6 

6 

Case 2 







37 

2F 

26 

1C 

11 

5 

5 









2E 

25 

IB 

10 

4 

4 










24 

1A 

F 

3 

3 











19 

E 

2 

2 












D 

1 


1 Case 1 (refer to User’s Manual) 0 
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Table 8 Example: Keycodes for KEY(y,x) = RESyx with 8 Scanlines 


y 

X 

RES6 

X 

RES5 

X 

RES4 

X 

RES3 

X 

RES2 

X 

RES1 

X 

RES0 

X 

7 

IB 

1A 

18 

15 

11 

C 

6 

6 


19 

17 

14 

10 

B 

5 

5 



16 

13 

F 

A 

4 

4 




12 

E 

9 

3 

3 





D 

8 

2 

2 






7 

1 

1 







0 


Concurrent Pressing of Keys 

The keypad module is able to detect concurrent pressing of multiple keys. Here the rules regarding unequal key 
row/column numbers are checked (refer to INCA-IP2 User’s Manual for details). 

Reporting to Kernel Module or User Application 

The reporting of key events can be done either to another kernel module (via placing a callback function) or to a 
user application (via ioctl’s). The two reporting paths are mutually exclusive; the instance that applies first “wins”: 

• A kernel module registers a callback function 

• A user application opens the keypad device. 

6.1.1 Proc File /proc/driver/keypad 

The INCA-IP2 keypad driver registers a proc file, which holds the current state of the key fifo with keycode, state 
and time stamp. 

6.2 LED Multiplexer 

The LED signals LEDO-9 are supported by the “tsf module. 

The LEDO-5 pins are always available. 

Pins LED6-9 may be multiplexed with GPIO, EBU or external interrupt pins. The “tsf” module queries the number 
of available LED pins from the mux module. 

During initialization a device “ledmatrix” will be created, which can be used to change LED settings from user 
space.. 

6.2.1 Proc File /proc/driver/ledmatrix 

The INCA-IP2 LED driver registers a proc file, which can be used to query information regarding the state of the 
LEDs. Also by writing to it the state of the LEDs can be changed. 


Table 9 LED Driver proc file commands 


Command 

Description 

led_set OxOOOOffOO 

Set LEDs to on, if corresponding bit is set to 1 

led_clr OxOOOOffOO 

Set LEDs to off, if corresponding bit is set to 1 

led_eth OxOOIfOOIf 

Set Ethernet LED config to specified value 
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6.2.2 Module Parameters 

The following module parameters are supported for LED features. 


Table 10 insmod Parameters 


Parameter 

Description 

led_eth_lan, 

led_eth_pc 

Defines which special function LEDs shall be controlled by ethernet hardware (lower 4 bits) 
and how (5th bit). The value is the logical OR of the following bits: 

LED_ETH_SPD (= 1) 

LED_ETH_ACT (= 2) 

LED_ETH_DPX (= 4) 

LED_ETH_STA (= 8) 

LED_ETH_TL (= 16) 

ncol 

Defines if a 2-column or 4-column LED matrix shall be controlled: 

2B , 2-column matrix 

4B , 4-column matrix 

inv 

Defines polarity of the column drivers: 

0B , LEDs sourced via external NPN transistors 

1 B , LEDs directly sourced 

Example: 


> insmod tsf ncol=2 

6.3 Pulse Width Modulator 

The “tsf module has control over the Pulse Width Modulator pins PWM1 and PWM2. Both are multiplexed with 
GPIO or EBU pins. The availability of these pins is enquired from the “mux” module. 

Each PWM - although very simple - is treated as a separate device with the names “pwml” and “pwm2”. 

6.3.1 Proc Files /proc/driver/pwml and /proc/driver/pwm2 

The INCA-IP2 LED driver registers a proc file, which can be used to query information regarding the state of the 
LEDs. Also by writing to it the state of the LEDs can be changed. 


'Infineon 


Table 1 1 PWM Driver proc files 

Proc File 

Description 

pwml 

Status of PWM1 device 

pwm2 

Status of PWM2 device 


6.3.2 Module Parameters 

For PWM support the following parameters are supported by the “tsf module. 


Table 12 insmod Parameters 


Parameter 

Description 

pwm1_value, 

pwm2_value 

Optionally a PWM value can be applied as an insmod parameter. If not applied, the init value 
is zero. 

Example: 


> insmod tsf pwml_value=127 
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6.4 Function Reference 

This chapter contains the Function reference. 


Table 13 FunctionOverview 


Name 

Description 

ifxpwmset 

Set PWM value. 

ifx_pwm_get 

Get PWM value. 

ifxpwmread 

Read PWM from device. 

ifxpwmwrite 

Write PWM to device. 

ifx_led_off 

Clear LED bits. 

ifx_led_on 

Set LED bits. 

ifx_led_ioctl 

LED matrix IOCTL handler. 

ifx_keypad_open 

Open keypad device. 

ifx_keypad_release 

Release keypad device. 

ifxkeypadioctl 

Keypad IOCTL handler. 

ifxkeypadpoll 

Poll handler. 

ifx_key_register_callback 

Register kaypad callback. 

ifxkeyunregistercallbac 

k 

Unregsiter callback function. 

ifxtsfinit 

Initialize TSF unit. 

ifx_tsf_exit 

Remove TSF module. 


6.4.1 ifx_pwm_set 


Description 

Set PWM value. 

This function sets the Pulse Width value of a PWM device. 

Prototype 

int ifx_pwm_set ( 
int id, 
u8 value ) ; 

Parameters 
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Data Type 

Name 

Description 

int 

id 

ID of the addressed PWM device 

u8 

value 

PWM value in the range 0..255 

Return Values 

Data Type 

Description 

int 

OOK 

-EINVAL Device not available or invalid value 
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6.4.2 ifx_pwm_get 

Description 

Get PWM value. 

This function gets the Pulse Width value of a PWM device. 

Prototype 

int ifx_pwm_get ( 
int id ) ; 

Parameters 
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Data Type 

Name 

Description 

int 

id 

ID of the addressed PWM device 


Return Values 


Data Type 

Description 

int 

>=0 current PWM value 

-EINVAL Device not available or invalid ID 


6.4.3 ifx_pwm_read 

Description 

Read PWM from device. 

This function is called when a user space program read from the PWM device. It will copy the current PWM value 

into the provided buffer. 

Prototype 

ssize_t ifx_pwm_read ( 

struct file * filp, 
char * buf , 
size_t count, 
loff_t * f_pos ) ; 

Parameters 


Data Type 

Name 

Description 

struct file * 

filp 

File structure of device node 

char * 

buf 

Destination buffer to copy data to 

size_t 

count 

Number of bytes to be read 

loff_t * 

f_pos 

Current position in file 
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Return Values 


Data Type 

Description 

ssize_t 

count Number of bytes read 


-EINVAL Invalid minor ID provided 


-EFAULT Error on copying data to user space 


6.4.4 ifx_pwm_write 

Description 

Write PWM to device. 

This function is called when a user space program writes to the PWM device. It will read the new PWM value from 

the buffer and then set it. If more than one byte shall be written and error will occur. 

Prototype 

ssize_t ifx_pwm_write ( 

struct file * filp, 
const char * buf, 
size_t count, 
loff_t * f_pos ) ; 

Parameters 


Data Type 

Name 

Description 

struct file * 

filp 

File structure of device node 

const char * 

buf 

Source buffer to read value from 

size_t 

count 

Number of bytes to be written (must be 1 ) 

loff_t * 

f_pos 

Current position in file 


Return Values 


Data Type 

Description 

ssize_t 

count Number of bytes written 

-EINVAL Invalid minor ID provided or to manny bytes written. 

-EFAULT Error on copying data from user space 


6.4.5 ifx_led_off 


Description 

Clear LED bits. 

Switch off the of the Matrix. All set bits in the 'indexLED' are switched off. Other bits are ignored 

Prototype 

u32 ifx_led_off ( 

u32 indexLED ) ; 
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Parameters 



Data Type 

Name 

Description 

u32 

indexLED 

bit vector as in register LED_REG 


Return Values 


Data Type 

Description 

u32 

0 If clearing the LED bits was successful! 

indexLED If the chip or the implementation doesn't support to clear one or more LEDs, 
the function is returning the indexLED bits that lead to the error. 


6.4.6 ifx_led_on 

Description 

Set LED bits. 

Switch on the of the Matrix. All set bits in the 'indexLED' are switched on. Other bits are ignored 

Prototype 

u32 ifx_led_on ( 

u32 indexLED ) ; 

Parameters 


Data Type 

Name 

Description 

u32 

indexLED 

bit vector as in register LED REG 


Return Values 


Data Type 

Description 

u32 

0 If setting the LED bits was successful! 

indexLED If the chip or the implementation doesn't support to set one or more LEDs, 
the function is returning the indexLED bits that lead to the error. 


6.4.7 ifxjedjoctl 

Description 

LED matrix IOCTL handler. 

The following lOCTLs are supported for the LED device. 

• LEDON 

• LEDOFF 

• LEDETHPC 

• LEDETHLAN 

Prototype 

int ifx_led_ioctl ( 
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struct inode * inode, 
struct file * filp, 
unsigned int cmd, 
unsigned long arg ) ; 


Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device 

struct file * 

filp 

File structure of device 

unsigned int 

cmd 

IOCTL command 

unsigned long 

arg 

Argument for some IOCTL commands 


Return Values 


Data Type 

Description 

int 

0 Setting the LED bits was successful! 

-ENOIOCTLCMD An invalid command was specified 


6.4.8 ifx_keypad_open 


Description 

Open keypad device. 

This function is called when the keypad device is opend. If the device is not opened from kernel already private 
data for the interrupt handler is initialized and then the interrupt is registerd. 

Prototype 

int i f x_keypad_open ( 

struct inode * inode, 
struct file * filp ) ; 

Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device 

struct file * 

filp 

File structure of device 


Return Values 


Data Type 

Description 

int 

0 OK, device opened 

-EINVAL There was a problem with request_irq 
-ENOMEM No more memory available 
-EBUSY Device is already opened from kernel 
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6.4.9 ifx_keypad_release 

Description 

Release keypad device. 

This function is called when the keypad device is closed. The interrupt will be released and the memory freed. 

Prototype 

int ifx_keypad_release ( 

struct inode * inode, 
struct file * filp ) ; 

Parameters 
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Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device 

struct file * 

filp 

File structure of device 


Return Values 


Data Type 

Description 

int 

0 OK, device opened 


6.4.10 ifx_keypad_ioctl 

Description 

Keypad IOCTL handler. 

The following IOCTL is supported for the keypad device. 

• KEYPADJ3ET 

Prototype 

int ifx_keypad_ioctl ( 

struct inode * inode, 
struct file * filp, 
unsigned int cmd, 
unsigned long arg ) % 

Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device 

struct file * 

filp 

File structure of device 

unsigned int 

cmd 

IOCTL command 

unsigned long 

arg 

Argument for some IOCTL commands 
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Return Values 


Data Type 

Description 

int 

OOK 

-ENOIOCTLCMD An invalid command was specified 

-EAGAIN No key event stored 

-EFAULT Error on copying data to user space 


6.4.11 ifxkeypadpoll 

Description 

Poll handler. 

For select calls from user space this function is called. It will sleep on the device wait queue until a key event is 
available. 

Prototype 

unsigned int ifx_keypad_poll ( 
struct file * filp, 
poll_table * wait ) ; 

Parameters 


Data Type 

Name 

Description 

struct file * 

filp 

File structure of device 

poll_table * 

wait 

Internal table of poll wait queues 


Return Values 


Data Type 

Description 

unsigned int 

mask If new data is available the POLLPRI bit is set, triggering an exception indication 


6.4.12 ifx_key_register_callback 


Description 

Register kaypad callback. 

This function is called by another kernel module to register a callback function for key events. 

Prototype 

int ifx_key_register_callback ( 
keypad_callback_t fp ) ; 

Parameters 


Data Type 

Name 

Description 

keypad_callback_t 

fp 

Pointer to callback function 
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Return Values 
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Data Type 

Description 

int 

-EBUSY Keypad device is already opended from user space. 

OOK 


6.4.13 ifx_key_unregister_callback 

Description 

Unregsiter callback function. 

This function is called by another kernel module to unregister its callback function. 

Prototype 

int ifx_key_unregister_callback ( 
void ) ; 

Parameters 


Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

int 

OOK 


6.4.14 ifx_tsf_init 

Description 

Initialize TSF unit. 

This function configures the TSF modules for keypad, ledmatrix and pwm and creates several proc file entries. 

Prototype 

ifx_void_t ifx_tsf_init ( 
void ) ; 

Parameters 


Data Type 

Name 

Description 

void 




6.4.15 ifx_tsf_exit 

Description 

Remove TSF module. 

Upon removal of the TSF module this function will free all allocated resources and unregister devices. 
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Prototype 

ifx_void_t ifx_tsf_exit ( 
void ) ; 

Parameters 


'Infineon 


Data Type 

Name 

Description 

void 




6.5 IOCTL Reference 

This chapter contains the IOCTL reference. 


Table 14 DefineOverview 

Name 

Description 

LEDON 

Switch LED on. 

LEDOFF 

Switch LED off. 

LED_ETH_PC 

Set PC Port LEDs. 

LEDETHLAN 

Set LAN Port LEDs. 


6.5.1 LED_ON 
Prototype 

#define LED_ON _IOW('T' i# 1, unsigned int) 

Parameters 


Data Type 

Name 

Description 

LEDON 

_IOW(T', 1, unsigned int) 

Switch LED on. 

Sets the LED bits specified in arg. 

6.5.2 LED_OFF 



Prototype 

#def ine LED_OFF _IOW('T' 

, 2, unsigned int) 


Parameters 



Data Type 

Name 

Description 

LED_OFF 

JOW(T, 2, unsigned int) 

Switch LED off. 

Clears the LED bits specified in arg. 


6.5.3 LED_ETH_PC 
Prototype 

ttdefine LED_ETH_PC _IOW('T', 3, unsigned char) 
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Parameters 



Data Type 

Name 

Description 

LED_ETH_PC 

_IOW(T', 3, unsigned char) 

Set PC Port LEDs. 

Sets the Ethernet LED bits specified in arg for 
PC port. 


6.5.4 LED_ETH_LAN 
Prototype 

#define LED_ETH_LAN _IOW('T', 4, unsigned char) 

Parameters 


Data Type 

Name 

Description 

LEDETHLAN 

_IOW(T, 4, unsigned char) 

Set LAN Port LEDs. 



Sets the Ethernet LED bits specified in arg for 



LAN port. 
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7 Ethernet Driver 

The ethernet driver registers an ethernet device at the kernel. Based on the ethernet driver the kernel provides the 
standard Linux/POSIX socket interface to user mode applications. The driver can be compiled into the kernel as 
well as a module. 

The kernel ethernet API is based on the net_device structure with function pointers for different control operations. 
The ethernet driver source can be found under source/kernel/ifx/bsp/drivers/net/incaip2_sw.c 

7.1 Function Reference 

This chapter contains the Function reference. 


Table 15 FunctionOverview 


Name 

Description 

ifxswitchopen 

Open network device. 

ifxswitchre lease 

Close network device. 

ifxswitchrx 

Switch receive. 

ifxswitchtx 

Write data to Ethernet switch. 

ifx_switch_tx_timeout 

Transmission timeout callback. 

ifx_switch_stats 

Get device statistics. 

ifxswitchsetmacaddre 

ss 

Set MAC address. 

ifx_switch_init 

Initialize switch driver. 


7.1.1 ifx_switch_open 


Description 

Open network device. 

This functions opens the network device and starts the interface queue. 

Prototype 

int ifx_switch_open ( 

struct net_device * dev ) ; 

Parameters 
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Data Type 

Name 

Description 

struct net_device * 

dev 

Device structure for Ethernet device 


Return Values 


Data Type 

Description 

int 

0 OK, device opened 



-1 Error, registering DMA device 
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7.1.2 ifx_switch_release 

Description 

Close network device. 

This functions closes the network device, which will also stop the interface queue. 

Prototype 

int ifx_switch_release ( 

struct net_device * dev ) ; 

Parameters 
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Data Type 

Name 

Description 

struct net_device * 

dev 

Device structure for Ethernet device 


Return Values 


Data Type 

Description 

int 

0 OK, device closed (cannot fail) 

7.1.3 ifx_switch 

i_rx 

Description 


Switch receive. 



This function reads data from Ethernet switch and passes it to upper network layer. It is called by 
ifx_switch_hw_receive after an DMA receive interrupt has occured. 

Prototype 

ifx_void_t ifx_switch_rx ( 

struct net_device * dev, 
int len, 

struct sk_buff * skb ) ; 

Parameters 


Data Type 

Name 

Description 

struct net_device * 

dev 

pointer to network device structure that holds 
DMA device information 

int 

len 

number of data bytes received from DMA 

struct sk_buff * 

skb 

pointer to socket buffer structure that contains 
the receiveddata to be sent 


7.1.4 ifx_switch_tx 

Description 

Write data to Ethernet switch. 
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This function writes the data comprised in skb structure via DMA to the Ethernet Switch. It is installed as the switch 
driver's hard_start_xmit method. 

Prototype 

int ifx_switch_tx ( 

struct sk_buff * skb, 
struct net_device * dev ) ; 

Parameters 
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Data Type 

Name 

Description 

struct sk_buff * 

skb 

Pointer to socket buffer structure that contains 

the data to be sent 

struct net_device * 

dev 

Pointer to network device structure which is 

used for data transmission 


Return Values 


Data Type 

Description 

int 

1 Transmission error 

0 OK, successful data transmission 


7.1.5 ifx_switch_tx_timeout 

Description 

Transmission timeout callback. 

This functions is called when a trasmission timeout occurs. It will wake up the interface queue again. 

Prototype 

ifx_void_t ifx_switch_tx_timeout ( 
struct net_device * dev ) ; 

Parameters 


Data Type 

Name 

Description 

struct net_device * 

dev 

Device structure for Ethernet device 


7.1.6 ifx_switch_stats 

Description 

Get device statistics. 

This functions returns the device statistics, stored in the device structure. 

Prototype 

net_de vie e_s tats * ifx_switch_stats ( 
struct net_device * dev ) ; 
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Parameters 



Data Type 

Name 

Description 

struct net_device * 

dev 

Device structure for Ethernet device 


Return Values 


Data Type 

Description 

net_device_stats * 

stats Pointer to statistics structure 


7.1.7 ifx_switch_set_mac_address 

Description 

Set MAC address. 

This functions sets the MAC address of the specified Ethernet device. 

Prototype 

int ifx_switch_set_mac_address ( 
struct net_device * dev, 
void * p ) ; 

Parameters 


Data Type 

Name 

Description 

struct net_device * 

dev 

Device structure for Ethernet device 

void * 

P 

Pointer to MAC address (array of 6 octets) 


Return Values 


Data Type 

Description 

int 

0 OK, MAC address set 

7.1.8 ifx_switch 

i_init 

Description 


Initialize switch driver. 



This functions initializes the switch driver structures and registers the Ethernet device. 

Prototype 

int ifx_switch_init ( 

struct net_device * dev ) ; 

Parameters 


Data Type 

Name 

Description 

struct net_device * 

dev 

Device structure for Ethernet device 
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Return Values 

Data Type 

Description 

int 

OOK 

ENOMEM No memory for structures available 

-1 Error during DMA init or Ethernet address configuration. 
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8 


Switch Access Interface 


This chapter describes the API provided by the switch access module. 

The sources are under “<kernel-dir>/arch/mips/infineon/incaip2/switchapi”. 


8.1 Switch and PHY System Overview 


The INCA-IP2 switch is a 3 port switch which allows to share one ethernet connection between the INCA-IP2 
phone itself and a PC. Therefore all incoming packets form the LAN have to be forwarded by the switch to the 
INCA-IP2 controller, to the PC or to both. Because the LAN and the PC ports of the switch are both ethernet 
interfaces these ports have also the same functionality. Via MAC modules these ports are connected to ethernet 
PHY’s. The PHYs provide standard functionality like auto-negotiation. 

The connection to the internal controller (CPU port) is done via a so called pseudo MAC (PMAC) because this is 
not an ethernet interface. 

While on the LAN and PC port the appropriate PHY transfers the data to the ethernet, the CPU port forwards the 
data via an internal DMA controller to the CPU. 

To work properly the mentioned modules of the switch have to be configured first. 

The ethernet switch device driver provides therefore interfaces to configure the PHYs, the switch MACs and also 
switch features like VLAN. 

8.2 Function Reference 

This chapter contains the Function reference. 


Table 16 FunctionOverview 


Name 

Description 

addrresljoctl 

Address resolution IOCTL handler. 

mac ioctl 

Mac IOCTL handler. 

portjoctl 

Port IOCTL handler. 

qosjoctl 

QoS IOCTL handler. 

switchjoctl 

Switch IOCTL handler. 

ifxmdioread 

Read MDIO register. 

ifx_mdio_write 

Write to MDIO register. 

s_api_open 

Open switch API device. 

sapirelease 

Close switch API device. 

sapiread 

Read switch API device. 

s_api_write 

Write to switch API device. 

s_api_ioctl 

Switch API IOCTL handler. 


8.2.1 addrresljoctl 


Description 

Address resolution IOCTL handler. 

IOCTL handler for address resolution configuration. The following IOCTLS are supported: 

• IFX_MAP_INGRESS_PRIORITY_COS 

• IFX_GET_INGRESS_PRIORITY_COS 

• IFX_MAP_COS_EGRESS_PRIORITY 

• IFX_GET_COS_EGRESS_PRIORITY 
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• IFX_MAP_COS_REDUCTION 

• IFX_GET_COS_REDUCTION 

• IFXVLANCHECK 

• I FX_SET_V LANAWARE 

• I FX_GET_VLAN_AWARE 

• IFX_GET_VLAN_IDX 

• I FX_GET_VLAN_M I B 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

struct file * 

file 

- File structure of device 

unsigned int 

cmd 

- IOCTL command 

unsigned long 

arg 

- Argument for some IOCTL commands 


Return Values 


Data Type 

Description 

int 

O-OK 


ENOTTY - Invalid command 


8.2.2 macjoctl 


Description 

Mac IOCTL handler. 

IOCTL handler for Mac address table modification. The following lOCTLs are supported: 

• I FX_GET_MAC_TABLE_I DX 

• IFX_ADD_MAC_TABLE_ENTRY 

• IFX_ADD_MAC_TABLE_ENTRY_IDX 

• I FX_GET_MAC_TABLE_ENTRY_I DX 

• I FX_G ET_M AC_T AB LE_ST AT 


Prototype 


Parameters 


Data Type 

Name 

Description 

struct file * 

file 

- File structure of device 

unsigned int 

cmd 

- IOCTL command 

unsigned long 

arg 

- Argument for some IOCTL commands 
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Data Type 

Description 

int 

O-OK 


ENOTTY - Invalid command 


8.2.3 portjoctl 


Description 

Port IOCTL handler. 

IOCTL handler for port configuration modification. The following lOCTLs are supported: 

• I FX_G ET_PORT_M I B_COU NTERS 

• IFX_SET_INGRESS_MONITOR_FLAG 

• IFX_GET_INGRESS_MONITOR_FLAG 

• IFX_SET_EGRESS_MONITOR_FLAG 

• IFX_GET_EGRESS_MONITOR_FLAG 

• IFX_PHY_READ 

• IFX_PHY_WRITE 

• IFX_SET_PORT_LOCK 

• IFX_GET_PORT_LOCK 

• I FX_SET_PORT_VLAN I D 

• I FX_G ET_PORT_VLAN I D 

• IFX_SET_PORT_INGRESS_VLAN_TAG 

• IFX_GET_PORT_INGRESS_VLAN_TAG 

• IFX_SET_PORT_INGRESS_VLAN_FILTER 

• IFX_GET_PORT_INGRESS_VLAN_FILTER 

• IFX_SET_PORT_COS 

• IFX_GET_PORT_COS 

• IFX_SET_PORT_JUMBO_ENABLE 

• IFX_GET_PORT_JUMBO_ENABLE 

Prototype 


Parameters 


Data Type 

Name 

Description 

struct file * 

file 

- File structure of device 

unsigned int 

cmd 

- IOCTL command 

unsigned long 

arg 

- Argument for some IOCTL commands 


Return Values 


Data Type 

Description 

int 

O-OK 


ENOTTY - Invalid command 


User’s Manual 
Programmer’s Reference 


65 


Revision 1.0, 2006-11-14 



INCA-IP2 

IP-Phone Solution, Linux® BSP Release 2.0 


CONFIDENTIAL 


Switch Access Interface 


8.2.4 qosioctl 

Description 

QoS IOCTL handler. 

IOCTL handler for QoS configuration. The following lOCTLs are supported: 

• IFX_GET_RULE_MEM 

• I FX_SET_PORT_KE Y 

• IFX_GET_PORT_KEY 

• IFX_SET_FLOW_PATTERN 

• IFX_GET_FLOW_PATTERN 

• IFXDELETEFLOWPATTERN 

• IFX_SET_FLOW_ACTION_PARAM 

• I FX_G ET_F LO W_ACTI O N_P AR AM 

• IFX_SET_PORT_RULE: 

• IFX_GET_PORT_RULE: 

• IFX_SET_PORT_MASK: 

• IFX_GET_PORT_MASK: 

• IFX_SET_PORT_OFFSET : 

• IFX_GET_PORT_OFFSET : 

• I FX_SET_RX_CON F IG : 

• I FX_G ET_RX_C O N F I G : 

• IFX_SET_QOS_BUCKET : 

• IFX_GET_QOS_BUCKET : 

• IFX_SET_QOS_BUCKET_FLOW_CONTROL: 

• IFX_GET_QOS_BUCKET_FLOW_CONTROL: 

• I FX_S ET_QO S_WF_Q U E U E : 

• IFX_GET_QOS_WF_QUEUE: 

• IFX_SET_QOS_SHAPING_QUEUE: 

• I FX_G ET_QOS_S H AP I N G_QU E U E : 

• IFX_SET_QOS_REPLENISH_RATE: 

• IFX_GET_QOS_REPLENISH_RATE: 

• IFX_SET_QOS_BURST_SIZE: 

• IFX_GET_QOS_BURST_SIZE: 

• I FX_S ET_QOS_EXTE N D_B U RST_S I Z E : 

• I FX_G ET_Q OSEXTE N D_B U RSTS IZ E : 

Prototype 


Parameters 


Data Type 

Name 

Description 

struct file * 

file 

- File structure of device 

unsigned int 

cmd 

- IOCTL command 

unsigned long 

arg 

- Argument for some IOCTL commands 
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Return Values 


Data Type 

Description 

int 

O-OK 


ENOTTY - Invalid command 


8.2.5 switchjoctl 

Description 

Switch IOCTL handler. 

IOCTL handler for switch configuration. The following lOCTLs are supported: 

• IFX_SET_INGRESS_WATERMARK 

• IFX_GET_INGRESS_WATERMARK 

• IFX_SET_EGRESS_WATERMARK 

• IFX_GET_EGRESS_WATERMARK 

• IFX_SET_TX_CONFIG 

• IFX_GETTX_CONFIG 

• IFX_SET_PORT_RATE_SHAPE 

• IFX_GET_PORT_RATE_SHAPE 

Prototype 


Parameters 


Data Type 

Name 

Description 

struct file * 

file 

- File structure of device 

unsigned int 

cmd 

- IOCTL command 

unsigned long 

arg 

- Argument for some IOCTL commands 


Return Values 


Data Type 

Description 

int 

O-OK 


ENOTTY - Invalid command 


8.2.6 ifx_mdio_read 


Description 

Read MDIO register. 
Read from Phy register. 

Prototype 
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Data Type 

Name 

Description 

u8 

chipld 

Chip Id 

u8 

phy_addr 

MDIO address of the PHY device 

u8 

RegOffset 

PHY register address 

u16 * 

pwData 

Pointer to Data read from phy register 


Return Values 


Data Type 

Description 

s32 

PR_ERR_NONE - Success 

PR_ERR_PHY_RD - If phy read fails 

PR ERR NULL PTR - pwData or base address is null pointer 

PRERRCHIPID - If the chip Id invalid 


8.2.7 ifx mdio write 

Description 

Write to MDIO register. 

Write 16 bit value wData to Phy register defined by passed phy_addr and RegOffset. 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

Chip Id 

u8 

phy_addr 

MDIO address of the PHY device 

u8 

RegOffset 

PHY register address 

u16 

wData 

Data to be written into phy register 


Return Values 


Data Type 

Description 

s32 

PR_ERR_NONE - Success 

PR_ERR_PHY_WR - If Phy write fails 

PR_ERR_NULL_PTR - Base address is null pointer 

PR ERR CHIP ID - If the chip Id invalid 


8.2.8 s_api_open 

Description 

Open switch API device. 

This function increases the usage count of the switch API device. 
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Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

- Inode of device 

struct file * 

file 

- File structure of device 


Return Values 


Data Type 

Description 

int 

0 - OK, device opened 


8.2.9 s_api_release 

Description 

Close switch API device. 

This function decreases the usage count of the switch API device. 

Prototype 


Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

- Inode of device 

struct file * 

file 

- File structure of device 


Return Values 


Data Type 

Description 

int 

0 - OK, device closed 


8.2.10 s_api_read 

Description 

Read switch API device. 

The switch API device does not support direct reading, thus this function does not return any data. 

Prototype 
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Data Type 

Name 

Description 

struct file * 

file 

- File structure of device node 

char * 

buf 

- Destination buffer to copy data to 

size_t 

count 

- Number of bytes to be read 

loff_t * 

offset 

- Current position in file 


Return Values 


Data Type 

Description 

ssize_t 

0 - Always zero 


8.2.11 s_api_write 

Description 

Write to switch API device. 

The switch API device does not support writing, thus this function does use any provided data. 

Prototype 


Parameters 


Data Type 

Name 

Description 

struct file * 

file 

- File structure of device node 

const char * 

buf 

- Destination buffer to copy data to 

size_t 

count 

- Number of bytes to be read 

loff_t * 

offset 

- Current position in file 


Return Values 


Data Type 

Description 

ssize_t 

0 - Always zero 


8.2.12 s_api_ioctl 

Description 

Switch API IOCTL handler. 

The IOCTL handler checks the given command and will call the appropriate subhandler. If an error occurs in the 
subhandler, its error code will also be returned from this function. The following subhandlers are available: 

• Address resolution configuration (addrresljoctl) 

• MAC configuration (macjoctl) 

• General port configuration (portjoctl) 

• COS configuration (qosjoctl) 
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• General switch configuration (switchjoctl) 

Prototype 


Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

- Inode of device 

struct file * 

file 

- File structure of device 

unsigned int 

cmd 

- IOCTL command 

unsigned long 

arg 

- Argument for some IOCTL commands 


Return Values 


Data Type 

Description 

int 

O-OK 

ENOTTY - Wrong IOC magic number or IOC number too large or invalid command 
EFAULT - Error accessing data from user space 


8.3 IOCTL Reference 

This chapter contains the IOCTL reference. 


Table 17 DefineOverview 


Name 

Description 

IFXMAPINGRESSPRIO 

RITYCOS 

Map ingress priority class of service IOCTL. 

IFXGETINGRESSPRIO 

RITYCOS 

Get ingress priority class of service IOCTL. 

IFX_MAP_COS_EGRESS_ 

PRIORITY 

Map egress priority class of service IOCTL. 

IFXGETCOSEGRESSP 

RIORITY 

Get egress priority class of service IOCTL. 

IFXMAPCOSREDUCTIO 

N 

Map class of service reduction IOCTL. 

IFX_GET_COS_REDUCTIO 

N 

Get class of service reduction IOCTL. 

IFX_SET_UNKNOWN_UCA 

ST_ID 

Set the Id for unknown unicast destination address. 

1 FX_G ET_U N KN 0 WN_U C A 
STID 

Get the Id for unknown unicast destination address. 

IFX_SET_UNKNOWN_MCA 

ST_ID 

Set the Id for unknown multicast destination address. 

IFXGETUNKNOWNMC 

ASTID 

Get the Id for unknown multicast destination address. 

1 FX_S ETBC ASTI D 

Set the Id for broadcast destination address. 
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Table 17 DefineOverview (cont’d) 


Name 

Description 

IFX_G ETBCASTI D 

Get the Id for broadcast destination address. 

IFX_SET_PMAC_TAG_INS 

ERTION 

Set VLAN Tag insertion at PMAC IOCTL. 

IFX_SET_VLAN_AWARE 

Set VLAN awarenes IOCTL. 

IFX_GET_VLAN_AWARE 

Get VLAN awarenes IOCTL. 

1 FX_G ET_VL AN_I DX 

Get VLAN index IOCTL. 

IFXGETVLANMIB 

Get MIB counters for VLAN/Flow IOCTL. 

IFXVLANCHECK 

Check VLAN existance IOCTL. 

IFX_ADD_VLAN_TABLE_E 

NTRY 

Add VLAN table entry IOCTL. 

IFXDELVLANTABLEE 

NTRY 

Delete VLAN table entry IOCTL. 

IFX_GET_VLAN_TABLE_E 

NTRY 

Get VLAN table entry IOCTL. 

1 FX_G ET_M ACT AB LE_I D 

X 

Get MAC table index IOCTL. 

1 FX_AD DM ACT AB L E_E 
NTRY_IDX 

Add MAC table entry with index IOCTL. 

1 FX_G ET_M AC_T AB LE_E N 
TRYIDX 

Get MAC table entry index IOCTL. 

IFXGETMACTABLEST 

AT 

Get MAC table statistics IOCTL. 

IFXADDMACTABLEE 

NTRY 

Add MAC table entry IOCTL. 

IFXCONTROLMACTAB 

LEAGING 

Control MAC table aging IOCTL. 

IFXSETPORTFEMODE 

Set Port Fast Ethernet Mode IOCTL. 

IFXG ETPORTF EMOD 

E 

Get Port Fast Ethernet Mode IOCTL. 

IFXSETPORTGEMOD 

E 

Set Port Gigabit Ethernet Mode IOCTL. 

IFXGETPORTGEMOD 

E 

Get Port Gigabit Ethernet Mode IOCTL. 

IFX_SET_INGRESS_MONI 

TOR_FLAG 

Set ingress monitor flag IOCTL. 

IFXGETINGRESSMONI 

TORFLAG 

Get ingress monitor flag IOCTL. 

IFX_SET_EGRESS_MONIT 

ORFLAG 

Set egress monitor flag IOCTL. 

IFX_GET_EGRESS_MONIT 

ORFLAG 

Get egress monitor flag IOCTL. 

IFXPHYREAD 

Read PHY register IOCTL. 

IFX_PHY_WRITE 

Write PHY register IOCTL. 

IFX_SET_PORT_LOCK 

Set port locking bit IOCTL. 
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Table 17 DefineOverview (cont’d) 


Name 

Description 

IFX_GET_PORT_LOCK 

Get port locking bit IOCTL. 

IFX_SET_PORT_VLANID 

Set port VLAN ID IOCTL. 

IFXGETPORTVLANID 

Get port VLAN ID IOCTL. 

IFX_SET_PORT_INGRESS 

VLANTAG 

Set VLAN Ingress Tag IOCTL. 

IFXGETPORTINGRESS 

VLANTAG 

Get VLAN Ingress Tag IOCTL. 

IFXSETPORTINGRESS 

VLANFILTER 

Set VLAN Ingress Filter IOCTL. 

IFX_GET_PORT_INGRESS 

VLANFILTER 

Get VLAN Ingress Filter IOCTL. 

IFXSETPORTCOS 

Set default CoS IOCTL. 

IFXGETPORTCOS 

Get default CoS IOCTL. 

IFX_SET_PORT_JUMBO_E 

NABLE 

Set Jumbo Enable flag IOCTL. 

IFX_GET_PORT_JUMBO_ 

ENABLE 

Get Jumbo Enable flag IOCTL. 

IFXGETPORTCONFIGU 

RATION 

Get Port Configuration IOCTL. 

IFX_GET_MDIO_MODE 

Get MDIO and autonegotiation mode IOCTL. 

IFXSETMDIOMODE 

Set MDIO and autonegotiation mode IOCTL. 

IFXGETMACMIBCOU 

NTERS 

Get MIB counters for MAC IOCTL. 

IFX_GET_PORT_MIB_COU 

NTERS 

Get MIB counters for port IOCTL. 

IFXSETPORTETHCON 

F 

Set Port Ethernet Configuration IOCTL. 

IFXGETPORTETHCON 

F 

Get Port Ethernet Configuration IOCTL. 

IFX_SET_PORT_KEY 

Set port keys IOCTL. 

IFXGETPORTKEY 

Get port keys IOCTL. 

IFXSETFLOWPATTERN 

Set rule for flow ID IOCTL. 

1 FX_G ET_F LO W_P ATTE R 

N 

Get rule for flow ID IOCTL. 

IFXDELETEFLOWPATT 

ERN 

Delete rule for flow ID IOCTL. 

IFX_SET_FLOW_ACTION_ 

PARAM 

Set action parameters for flow ID IOCTL. 

IFX_GET_FLOW_ACTION_ 

PARAM 

Get action for flow ID IOCTL. 

IFXSETPORTRULE 

Set rule for port ID IOCTL. 

IFX_GET_PORT_RULE 

Get rule for port ID IOCTL. 

1 FX_S ETPO RT_M AS K 

Set rule mask for port ID IOCTL. 
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Table 17 DefineOverview (cont’d) 


Name 

Description 

IFX_GET_PORT_MASK 

Get rule mask for port ID IOCTL. 

IFX_SET_PORT_OFFSET 

Set offset for port ID IOCTL. 

IFXGETPORTOFFSET 

Get offset for port ID IOCTL. 

IFX_SET_RX_CONFIG 

Set the RX configuration IOCTL. 

IFX_GET_RX_CONFIG 

Get the RX configuration IOCTL. 

IFXSETQOSBUCKET 

Set values for token bucket ID IOCTL. 

IFXGETQOSBUCKET 

Get values for token bucket ID IOCTL. 

1 FX_S ETQOSB U C KET_F 
LOWCONTROL 

Set flow control for token bucket ID IOCTL. 

IFXGETQOSBUCKETF 

LOWCONTROL 

Get flow control for token bucket ID IOCTL. 

IFXSETQOSWFQUEU 

E 

Set parameters for WFQ IOCTL. 

IFX_GET_QOS_WF_QUEU 

E 

Get parameters for WFQ IOCTL. 

IFX_SET_QOS_SHAPING_ 

QUEUE 

Set parameters for rate shaping IOCTL. 

IFX_GET_QOS_SHAPING_ 

QUEUE 

Get parameters for rate shaping IOCTL. 

IFX_SET_QOS_REPLENIS 

HRATE 

Set token bucket replenish rate IOCTL. 

IFXGETQOSREPLENIS 

HRATE 

Get token bucket replenish rate IOCTL. 

IFX_SET_QOS_BURST_SI 

ZE 

Set token bucket burst size IOCTL. 

IFXGETQOSBURSTSI 

ZE 

Get token bucket burst size IOCTL. 

IFXSETQOSEXTENDB 

URSTSIZE 

Set token bucket extended burst size IOCTL. 

IFXG ETQOSEXTEN D_B 
URSTSIZE 

Get token bucket extended burst size IOCTL. 

IFXGETRULEMEM 

Get rule memory IOCTL. 

IFX_SET_INGRESS_WATE 

RMARK 

Set Ingress watermark IOCTL. 

IFXGETINGRESSWATE 

RMARK 

Get Ingress watermark IOCTL. 

IFX_SET_EGRESS_WATE 

RMARK 

Set Egress watermark IOCTL. 

IFX_GET_EGRESS_WATE 

RMARK 

Get Egress watermark IOCTL. 

IFXSETTXCONFIG 

Set Tx config IOCTL. 

IFX_GET_TX_CONFIG 

Get Tx config IOCTL. 

IFX_SET_PORT_RATE_SH 

APE 

Enable port rate shaping IOCTL. 
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Table 17 DefineOverview (cont’d) 

Name 

Description 

IFX_GET_PORT_RATE_SH 

APE 

Get port rate shaping flag IOCTL. 

IFX_SET_PAUSE_FRAME_ 

GEN 

Enable/Disable Pause Frame generation IOCTL. 

IFX_GET_PAUSE_FRAME_ 

GEN 

Get port rate shaping flag IOCTL. 


8.3.1 IFXMAPINGRESSPRIORITYCOS 


Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_MAP_INGRESS_PRIORI 

TYCOS 

_IOW(IFX_IOC_MAGIC,3,cos 

_pr_api) 

Map ingress priority class of service IOCTL. 
Calls 

ifx_map_ingress_priority_CoS(arg.chipld, 
arg. Priority, arg.CoS); 


8.3.2 IFX_GET_INGRESS_PRIORITY_COS 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_GET_INGRESS_PRIORIT 

Y_COS 

_IOR(IFX_IOC_MAGIC,4,cos 

_pr_api) 

Get ingress priority class of service IOCTL. 

Calls 

ifx_get_ingress_priority_CoS(arg.chipld, 
arg. Priority, &arg.CoS); 

8.3.3 IFXMAPCOS 

_EGRESS_PRIORITY 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_MAP_COS_EGRESS_PR 

IORITY 

_IOW(IFX_IOC_MAGIC,5,cos 

_P r _api) 

Map egress priority class of service IOCTL. 

Calls 

ifx_map_CoS_egress_priority(arg.chipld, 
arg.CoS, arg. Priority); 
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8.3.4 IFX_GET_COS 

_EGRESS_PRIORITY 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_GET_COS_EGRESS_PRI 

ORITY 

_IOR(IFX_IOC_MAGIC,6,cos 

_pr_api) 

Get egress priority class of service IOCTL. 

Calls 

ifx_get_CoS_egress_priority(arg.chipld, 
arg.CoS, &arg. Priority); 


8.3.5 IFX_MAP_COS_REDUCTION 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_MAP_COS_REDUCTION 

_IOW(IFX_IOC_MAGIC,7,cos 

_rd_api) 

Map class of service reduction IOCTL. 

Calls ifx_map_CoS_reduction(arg.chipld, 
arg.CoS, arg. reduction); 

8.3.6 IFX_GET_COS_ 

.REDUCTION 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_GET_COS_REDUCTION 

_IOR(IFX_IOC_MAGIC,8,cos 

_rd_api) 

Get class of service reduction IOCTL. 

Calls ifx_get_CoS_reduction(arg.chipld, 
arg.CoS, &arg. reduction); 


8.3.7 IFX_SET_UNKNOWN_UCAST_ID 

Prototype 
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Parameters 



Data Type 

Name 

Description 

IFX_SET_UNKNOWN_UCAST 

_ID 

_IOW(IFX_IOC_MAGIC,9,IFX 

ZEROSIZE) 

Set the Id for unknown unicast destination 

address. 

Calls ifx_set_unknown_ucast_ID(arg.chipld, 
arg.floodld); 

8.3.8 IFX_GET_UNKNOWN_UCAST_ID 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_GET_UNKNOWN_UCAS 

T_ID 

_IOR(IFX_IOC_MAGIC,10,IF 

X_ZERO_SIZE) 

Get the Id for unknown unicast destination 

address. 

Calls ifx_get_unknown_ucast_ID(arg.chipld, 
&arg .flood Id); 


8.3.9 IFX_SET_UNKNOWN_MCAST_ID 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_S ET_U N KN O WN_M CAS 
T_ID 

_IOW(IFX_IOC_MAGIC,1 1 ,IF 
X_ZERO_SIZE) 

Set the Id for unknown multicast destination 

address. 

Calls ifx_set_un known_mcast_ID(arg .ch ipld , 
arg.floodld); 


8.3.10 IFX_GET_UNKNOWN_MCAST_ID 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_GET_UNKNOWN_MCAS 

T_ID 

_IOR(IFX_IOC_MAGIC,12,IF 

X_ZERO_SIZE) 

Get the Id for unknown multicast destination 

address. 

Calls ifx_get_unknown_mcast_ID(arg.chipld, 
&arg.floodld); 
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8.3.11 I FX_S ET_BC AST_I D 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

IFX SET BCAST ID 

IOW(IFX IOC MAGIC, 13, IF 

Set the Id for broadcast destination address. 


X_ZERO_SIZE) 

Calls ifx_set_bcast_ID(arg.chipld, 
arg.floodld); 

8.3.12 IFX GET BCAST ID 


Prototype 



Parameters 



Data Type 

Name 

Description 

1 FX_G ET_BCAST_I D 

_IOR(IFX_IOC_MAGIC,14,IF 

Get the Id for broadcast destination address. 


X_ZERO_SIZE) 

Calls ifx_get_bcast_ID(arg.chipld, 

&arg .flood Id); 

8.3.13 IFX SET PMAC TAG INSERTION 


Prototype 



Parameters 

Data Type 

Name 

Description 

1 FX_SET_PMAC_TAG_I NSER 

_l 0 W( 1 FX_I OC_M AG 1 C , 1 6 , p 

Set VLAN Tag insertion at PMAC IOCTL. 

TION 

mac_vlan_api) 

Calls 

ifx_pmac_vlan_tag_insertion(arg.chipld, 
arg.en_dis,arg.Vlanld, arg.prio,0); 

8.3.14 IFX SET VLAN AWARE 





Prototype 
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Data Type 

Name 

Description 

IFX SET VLAN AWARE 

IOW(IFX IOC MAGIC, 17, via 

Set VLAN awarenes IOCTL. 


n_aware_api) 

Calls ifx_set_VLAN_aware(arg.chipld, 
arg.VlanAwareFlag); 

8.3.15 IFX GET VLAN AWARE 


Prototype 



Parameters 



Data Type 

Name 

Description 

1 FX_G ET_VLAN_AWARE 

_IOR(IFX_IOC_MAGIC,18,vla 

Get VLAN awarenes IOCTL. 


n_aware_api) 

Calls ifxgetV LAN a wa re(a rg . ch i p 1 d , 
&arg.VlanAwareFlag); 

8.3.16 IFX GET VLAN IDX 


Prototype 



Parameters 

Data Type 

Name 

Description 

1 FX_G ET_VLAN_I DX 

_l 0 R( 1 FX_I OC_M AG 1 C , 2 1 ,vla 

Get VLAN index IOCTL. 


n_idx_api) 

Calls ifx_get_VLAN_idx(arg.chipld, 
arg.vlanld, &arg.Vlanlndex); 

8.3.17 IFX GET VLAN MIB 


Prototype 



Parameters 

Data Type 

Name 

Description 

1 FX_G ET_V LAN_M 1 B 

_IOR(IFX_IOC_MAGIC,22,mi 

Get MIB counters for VLAN/Flow IOCTL. 


b_idx_api) 

Calls ifx_get_VLAN_mib(arg.chipld, 
arg.mibldx, arg.counterld, &arg. count); 


8.3.18 IFXVLANCHECK 

Prototype 
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Parameters 



Data Type 

Name 

Description 

IFX_VLAN_CHECK 

_IOR(IFX_IOC_MAGIC,35,vla 

n_status_api) 

Check VLAN existance IOCTL. 

Calls (arg.chipld, arg.vlanld, &arg.flag); 


8.3.19 IFX_ADD_VLAN_TABLE_ENTRY 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FXAD DVLANTAB LEENT 

RY 

_IOW(IFX_IOC_MAGIC,38,vla 

n_tableentry_api) 

Add VLAN table entry IOCTL. 

Calls ifx_add_vlan_entry(arg.chipld, 
arg.vlanld, &arg.portmemberList, 
&arg.portegressList, arg.valid); 


8.3.20 IFXDELVLANTABLEENTRY 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_DEL_VLAN_TABLE_ENT 

_IOW(IFX_IOC_MAGIC,39,vla 

Delete VLAN table entry IOCTL. 

RY 

n_tableentry_api) 

Calls ifx_delete_vlan_entry(arg.chipld, 
arg.vlanld ); 


8.3.21 IFX_GET_VLAN_TABLE_ENTRY 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_VLAN_TABLE_ENT 
RY 

_IOR(IFX_IOC_MAGIC,40,vla 

n_tableentry_api) 

Get VLAN table entry IOCTL. 

Calls 

ifx_get_vlan_table_entry(vte_api.chipld, 

vte_api.vlanld, 

(u32*)&vte_api.portmemberList, 
(u32‘)&vte_api.portegressList, &vte_api. valid); 


User’s Manual 
Programmer’s Reference 


Revision 1.0, 2006-11-14 


INCA-IP2 

IP-Phone Solution, Linux® BSP Release 2.0 

CONFIDENTIAL Switch Access Interface 

8.3.22 I FX_G ET_M ACT AB LE_I DX 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_MAC_TABLE_I DX 

_IOR(IFX_IOC_MAGIC,66,ma 

Get MAC table index IOCTL. 


cTidx_api) 

Calls ifx_get_MAC_table_idx(arg.macAddr, 
arg.tablelndex); 


8.3.23 IFXADDMACTABLEENTRYIDX 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

1 FXAD DMACTABLEENT 

RYIDX 

_l 0 W( 1 FX_I OC_M AG 1 C ,67, m 
acTenldex_api) 

Add MAC table entry with index IOCTL. 

Calls 

ifx_add_MAC_table_entry_idx(arg.chipld, 
arg.macTablelndex, arg.macAddr, 
arg.lan_port, arg.pc_port, arg.cpu_port, 
arg.criticalFlag, arg.maState); 


8.3.24 IFX_GET_MAC_TABLE_ENTRY_IDX 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_GET_MAC_TABLE_ENT 

RYIDX 

_IOR(IFX_IOC_MAGIC,68,ma 

cTenldex_api) 

Get MAC table entry index IOCTL. 

Calls 

ifx_get_MAC_table_entry_idx(arg.chipld, 
arg.macTablelndex, arg.macAddr, 
arg.lan_port, arg.pc_port, arg.cpu_port, 
arg.criticalFlag, arg.maState); 

8.3.25 IFX_GET_MAC 

TABLESTAT 



Prototype 
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Parameters 



Data Type 

Name 

Description 

1 FX_G ET_M AC_T AB LE_ST AT 

_IOR(IFX_IOC_MAGIC,70,ma 

cTstat_api) 

Get MAC table statistics IOCTL. 

Calls ifx_get_MAC_table_stat(arg.chipld, 
arg.staticCount, arg.valid); 


8.3.26 IFXADDMACTABLEENTRY 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_AD DMACTABLEE N T 
RY 

_l 0 W( 1 FX_I OC_M AG 1 C ,7 1 , m 
acTenldex_api) 

Add MAC table entry IOCTL. 

Calls (arg.macAddr, arg.lan_port, arg.pc_port, 
arg.cpu_port, arg.criticalFlag, arg.maState); 

8.3.27 IFXCONTROL 

_MAC_TABLE_AGING 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_CONTROL_MAC_TABLE 

_AGING 

_IOW(IFX_IOC_MAGIC,72,m 

acAging_api) 

Control MAC table aging IOCTL. 

Calls (arg.macAddr, arg.lan_port, arg.pc_port, 
arg.cpu_port, arg.criticalFlag, arg.maState); 

8.3.28 IFX_SET_PORT_FE_MODE 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_SET_PORT_FE_MODE 

_l 0 W( 1 FX_I OC_M AG 1 C , 76 , po 
rtMode_api) 

Set Port Fast Ethernet Mode IOCTL. 

Calls ifx_set_port_FE_mode( arg.chipld, 
arg.portld, arg.feature, arg.mode ); 


8.3.29 IFX_GET_PORT_FE_MODE 

Prototype 
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Parameters 



Data Type 

Name 

Description 

IFX_GET_PORT_FE_MODE 

_IOR(IFX_IOC_MAGIC,77,por 

tMode_api) 

Get Port Fast Ethernet Mode IOCTL. 

Calls ifx_get_port_FE_mode arg.chipld, 
arg.portld, arg.feature, &arg.mode) 


8.3.30 IFX_SET_PORT_GE_MODE 


Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_SET_PORT_GE_MODE 

_IOW(IFX_IOC_MAGIC,78,po 

rtModeapi) 

Set Port Gigabit Ethernet Mode IOCTL. 

Calls ifx_set_port_GE_mode( arg.chipld, 
arg.portld, arg.feature, arg.mode ); 


8.3.31 IFX_GET_PORT_GE_MODE 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_GET_PORT_GE_MODE 

_IOR(IFX_IOC_MAGIC,79,por 

tMode_api) 

Get Port Gigabit Ethernet Mode IOCTL. 

Calls ifx_get_port_GE_mode arg.chipld, 
arg.portld, arg.feature, &arg.mode) 


8.3.32 IFX_SET_INGRESS_MONITOR_FLAG 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_SET_INGRESS_MONITO 

RFLAG 

_IOW(IFX_IOC_MAGIC,81 ,FI 
ag_api) 

Set ingress monitor flag IOCTL. 

Calls 

ifx_set_ingress_monitor_flag(arg.chipld, 
arg.portld, arg.flag); 
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8.3.33 IFX_GET_INGRESS_MONITOR_FLAG 

Prototype 


Infineon 


Parameters 


Data Type 

Name 

Description 

IFX_GET_INGRESS_MONITO 

R_FLAG 

_IOR(IFX_IOC_MAGIC,82,Fla 

9_api) 

Get ingress monitor flag IOCTL. 

Calls 

ifx_get_ingress_monitor_flag(arg.chipld, 
arg.portld, &arg.flag); 


8.3.34 IFX_SET_EGRESS_MONITOR_FLAG 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_SET_EGRESS_MONITO 

R_FLAG 

_IOW(IFX_IOC_MAGIC,83,FI 

ag_api) 

Set egress monitor flag IOCTL. 

Calls 

ifx_set_egress_monitor_flag(arg.chipld, 
arg.portld, arg.flag); 


8.3.35 IFX_GET_EGRESS_MONITOR_FLAG 


Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_EG RESS _MON ITO 
R_FLAG 

_IOR(IFX_IOC_MAGIC,84,Fla 

g_api) 

Get egress monitor flag IOCTL. 

Calls 

ifx_get_egress_monitor_flag(arg.chipld, 
arg.portld, &arg.flag); 


8.3.36 IFX_PHY_READ 

Prototype 
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Parameters 



Data Type 

Name 

Description 

IFX_PHY_READ 

_IOR(IFX_IOC_MAGIC,85,ph 

yAction_api) 

Read PHY register IOCTL. 

Calls ifx_phy_read(arg.chipld, arg.mdiojd, 
arg.phy_addr, a rg. Reg Offset, &arg.Data); 


8.3.37 IFXPHYWRITE 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_PHY_WRITE 

_IOW(IFX_IOC_MAGIC,86,ph 

Write PHY register IOCTL. 


yAction_api) 

Calls ifx_phy_write(arg.chipld, arg.mdiojd, 
arg.phy_addr, a rg. Reg Offset, arg.Data); 


8.3.38 IFX_SET_PORT_LOCK 


Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_SET_PORT_LOCK 

J OW(l FXJ OC_M AG 1 C, 87, FI 

Set port locking bit IOCTL. 


ag_api) 

Calls ifx_set_portJock(arg.chipld, arg.portld, 
arg.flag); 


8.3.39 I FX_G ET_PO RT_LOC K 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_PORT_LOCK 

JOR(IFXJOC_MAGIC,88,Fla 

Get port locking bit IOCTL. 


9_api) 

Calls ifx_get_portJock(arg.chipld, arg.portld, 
&arg.flag); 


8.3.40 IFXSETPORTVLANID 

Prototype 
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Parameters 



Data Type 

Name 

Description 

1 FX_SET_PORT_VLAN 1 D 

_IOW(IFX_IOC_MAGIC,89,po 

rtVlan_api) 

Set port VLAN ID IOCTL. 

Calls ifx_set_port_VLANId(arg.chipld, 
arg.portld, arg.vlanid); 

8.3.41 IFX_GET_PORT_VLANID 


Prototype 



Parameters 



Data Type 

Name 

Description 

1 FX_G ET_PO RTVLAN 1 D 

IOR(IFX_l OC_M AG 1 C , 90 , por 

tVlan_api) 

Get port VLAN ID IOCTL. 

Calls ifx_get_port_VLANId(arg.chipld, 
arg.portld, &arg.vlanid); 

8.3.42 IFXSETPORTINGRESSVLANTAG 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_SET_PORT_INGRESS_V 

LAN_TAG 

_IOW(IFX_IOC_MAGIC,91 ,FI 
ag_api) 

Set VLAN Ingress Tag IOCTL. 

Calls 

ifx_set_port_ingress_VLAN_tag(arg.chipld, 
arg.portld, arg.flag); 


8.3.43 IFX_GET_PORT_INGRESS_VLAN_TAG 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_PORT_INGRESS_V 
LANTAG 

JOR(IFX_IOC_MAGIC,92,Fla 

9_api) 

Get VLAN Ingress Tag IOCTL. 

Calls 

ifx_get_port_ingress_VLAN_tag(arg.chipld, 
arg.portld, &arg.flag); 
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8.3.44 IFX_SET_PORT_INGRESS_VLAN_FILTER 

Prototype 


Infineon 


Parameters 


Data Type 

Name 

Description 

IFX_SET_PORT_INGRESS_V 

LANFILTER 

_l 0 W( 1 FX_I OC_M AG 1 C , 93 , FI 
ag_api) 

Set VLAN Ingress Filter IOCTL. 

Calls 

ifx_set_port_ingress_VLAN_filter(arg.chipld 
, arg.portld, arg.flag); 


8.3.45 IFX_GET_PORT_INGRESS_VLAN_FILTER 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_PORT_INGRESS_V 
LAN_FILTER 

_IOR(IFX_IOC_MAGIC,94,Fla 

9_api) 

Get VLAN Ingress Filter IOCTL. 

Calls 

ifx_get_port_ingress_VLAN_filter(arg.chipld 
, arg.portld, &arg.flag); 


8.3.46 IFXSETPORTCOS 


Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_SET_PORT_COS 

_IOW(IFX_IOC_MAGIC,95,po 

Set default CoS IOCTL. 


rtCoS_api) 

Calls ifx_set_port_CoS(arg.chipld, arg.portld, 
arg.CoS); 


8.3.47 IFX_GET_PORT_COS 

Prototype 
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Parameters 



Data Type 

Name 

Description 

1 FX_G ET_PORT_COS 

_IOR(IFX_IOC_MAGIC,96,por 

tCoS_api) 

Get default CoS IOCTL. 

Calls ifx_get_port_CoS(arg.chipld, arg.portld, 
&arg.CoS); 

8.3.48 IFX_SET_PORT_JUMBO_ENABLE 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_SET_PORT_JUMBO_EN 

ABLE 

_IOW(IFX_IOC_MAGIC,97,FI 

ag_api) 

Set Jumbo Enable flag IOCTL. 

Calls ifx_set_portJumbo_enable(arg.chipld, 
arg.portld, arg.flag); 

8.3.49 IFX_GET_PORT_JUMBO_ENABLE 


Prototype 



Parameters 



Data Type 

Name 

Description 

1 FX_G ET_PO RT_J U M BO_E N 
ABLE 

_IOR(IFX_IOC_MAGIC,98,Fla 

9_api) 

Get Jumbo Enable flag IOCTL. 

Calls ifx_get_portJumbo_enable(arg.chipld, 
arg.portld, &arg.flag); 

8.3.50 IFX_GET_PORT_CONFIGURATION 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_GET_PORT_CONFIGUR 

ATION 

_IOR(IFX_IOC_MAGIC,99,por 

tCoS_api) 

Get Port Configuration IOCTL. 

Calls 

ifx_get_port_default_configuration(arg.chipl 
d, arg.portld, &arg.CoS)); 
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8.3.51 IFX_GET_MDIO_MODE 

Prototype 


Infineon 


Parameters 


Data Type 

Name 

Description 

IFX_GET_MDIO_MODE 

_IOR(IFX_IOC_MAGIC,100,m 

diomode_api) 

Get MDIO and autonegotiation mode IOCTL. 
Calls ifx_get_MDIO_mode(arg.chipld, 
arg.port_group, &arg.mdioMode, 
&arg.autoNegMode); 


8.3.52 IFX_SET_MDIO_MODE 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_S ET_M D 1 0_M ODE 

_IOW(IFX_IOC_MAGIC,101 , 
mdiomode_api) 

Set MDIO and autonegotiation mode IOCTL. 
Calls ifx_set_MDIO_mode(arg.chipld, 
arg.port_group, arg.mdioMode, 
arg.autoNegMode); 


8.3.53 IFXGETMACMIBCOUNTERS 


Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_MAC_M 1 B_COU NT 
ERS 

_IOR(IFX_IOC_MAGIC,102,m 

ibCounters_api) 

Get MIB counters for MAC IOCTL. 

Calls ifx_get_mac_MIB_counters(arg.chipld, 
arg.portld, arg.counterld, &arg. count); 


8.3.54 IFX_GET_PORT_MIB_COUNTERS 

Prototype 
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Data Type 

Name 

Description 

1 FX_G ET_PORT_M IB_COUN 

_IOR(IFX_IOC_MAGIC, 103,m 

Get MIB counters for port IOCTL. 

TERS 

ibCounters_api) 

Calls ifx_get_port_MIB_counters(arg.chipld, 
arg.portld, arg.counterld, &arg. count); 

8.3.55 IFX SET PORT ETH CONF 


Prototype 




Parameters 

Data Type 

Name 

Description 

IFX_SET_PORT_ETH_CONF 

_IOW(IFX_IOC_MAGIC,104,p 

ort_eth_conf_api) 

Set Port Ethernet Configuration IOCTL. 

Calls ifx_set_port_eth_conf( arg.chipld, 
arg.portld, arg. speed, arg. duplex, arg.autoneg, 
arg.int_ext_phy); 

8.3.56 IFX_GET_PORT_ETH_CONF 

Prototype 

Parameters 

Data Type 

Name 

Description 

1 FX_G ET_PORT_ETH_CONF 

_IOR(IFX_IOC_MAGIC,105,p 

ort_eth_conf_api) 

Get Port Ethernet Configuration IOCTL. 

Calls ifx_get_port_eth_conf( arg.chipld, 
arg.portld, &arg. speed, &arg. duplex, 
&arg.autoneg, &arg.int_ext_phy, 
&arg.link_status); 

8.3.57 IFXSETPORTKEY 

Prototype 

Parameters 

Data Type 

Name 

Description 

1 FX_SET_PORT_KEY 

_IOW(IFX_IOC_MAGIC,1 1 1,p 
ortKey_api) 

Set port keys IOCTL. 

Calls ifx_set_port_key(arg.chipld, arg.portld, 
arg.lKey); 
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8.3.58 IFX_GET_PORT_KEY 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_PORT_KEY 

_IOR(IFX_IOC_MAGIC,1 12,p 

Get port keys IOCTL. 


ortKey_api) 

Calls ifx_get_port_key(arg.chipld, arg.portld, 
&arg,IKey); 


8.3.59 I FXSETF LOWPATTE RN 


Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_SET_FLOW_PATTERN 

_IOW(IFX_IOC_MAGIC,1 13,fl 

Set rule for flow ID IOCTL. 


owPattern_api) 

Calls ifx_set_flow_pattern(arg.chipld, 
arg.flowld, arg.lKeyData, arg.lKeyMask); 


8.3.60 IFXGETFLOWPATTERN 


Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_FLOW_PATTERN 

_IOR(IFX_IOC_MAGIC,1 14,fl 

Get rule for flow ID IOCTL. 


owPattern_api) 

Calls ifx_get_flow_pattern(arg.chipld, 
arg.flowld, arg.lKeyData, arg.lKeyMask); 


8.3.61 IFX_DELETE_FLOW_PATTERN 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_DELETE_FLOW_PATTE 

_IOW(IFX_IOC_MAGIC,1 15,fl 

Delete rule for flow ID IOCTL. 

RN 

owld_api) 

Calls ifx_delete_flow_pattern(arg.chipld, 
arg.flowld); 
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8.3.62 IFX_SET_FLOW_ACTION_PARAM 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

IFX_SET_FLOW_ACTION_PA 

RAM 

_IOW(IFX_IOC_MAGIC,1 16,fl 
owParam_api) 

Set action parameters for flow ID IOCTL. 

Calls ifx_set_flow_action_param(arg.chipld, 
arg.flowld, arg.feature, arg.flowAction); 

8.3.63 

IFX_GET_FLOW_ACTION_PARAM 


Prototype 





Parameters 

Data Type 

Name 

Description 

IFX_GET_FLOW_ACTION_PA 

RAM 

_IOR(IFX_IOC_MAGIC,1 17,fl 
owParam_api) 

Get action for flow ID IOCTL. 

Calls ifx_get_flow_action_param(arg.chipld, 
arg.flowld, arg.feature, &arg.flowAction); 

8.3.64 IFX_SET_PORT_RULE 


Prototype 




Parameters 



Data Type 

Name 

Description 

IFX_SET_PORT_RULE 

_IOW(IFX_IOC_MAGIC,120,p 

ortRule_api) 

Set rule for port ID IOCTL. 

Calls ifx_set_port_rule(arg.chipld, arg.portld, 
arg.portRule); 

8.3.65 IFX_GET_PORT_RULE 

Prototype 


Parameters 

Data Type 

Name 

Description 

IFX_GET_PORT_RULE 

_IOR(IFX_IOC_MAGIC,121,p 

ortRule_api) 

Get rule for port ID IOCTL. 

Calls ifx_get_port_rule(arg.chipld, arg.portld, 
arg.portRule); 
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8.3.66 IFX_SET_PORT_MASK 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_SET_PORT_MASK 

_IOW(IFX_IOC_MAGIC,122,p 

Set rule mask for port ID IOCTL. 


ortRule_api) 

Calls ifx_set_port_mask(arg.chipld, 



arg.portld, arg.portRule); 


8.3.67 IFX_GET_PORT_MASK 

Prototype 


Infineon 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_PORT_M ASK 

_IOR(IFX_IOC_MAGIC,123,p 

Get rule mask for port ID IOCTL. 


ortRule_api) 

Calls ifx_get_port_mask(arg.chipld, 



arg.portld, arg.portRule); 


8.3.68 IFXSETPORTOFFSET 


Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_S ET_PO RT_0 F FS ET 

_l 0 W( 1 FX_I OC_M AG 1 C , 1 24 , p 

Set offset for port ID IOCTL. 


ortOffset_api) 

Calls ifx_set_port_offset(arg.chipld, 



arg.portld, arg.portOffset); 


8.3.69 IFX_GET_PORT_OFFSET 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_GET_PORT_OFFSET 

_IOR(IFX_IOC_MAGIC,125,p 

Get offset for port ID IOCTL. 


ortOffset_api) 

Calls ifx_get_port_offset(arg.chipld, 



arg.portld, arg.portOffset); 
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8.3.70 IFX_SET_RX_CONFIG 

Prototype 


Infineon 


Parameters 


Data Type 

Name 

Description 

1 FX_S ET_RX_CO N F 1 G 

_IOW(IFX_IOC_MAGIC,126,R 

xConfig_api) 

Set the RX configuration IOCTL. 

Calls ifx_set_Rx_config(arg.chipld, 
arg.portld, arg.L3Program, arg.L3StartVld, 
arg.L3Start); 

8.3.71 IFX_GET_RX_CONFIG 


Prototype 



Parameters 



Data Type 

Name 

Description 

1 FX_G ET_RX_CON FI G 

_IOR(IFX_IOC_MAGIC,127,R 

xConfig_api) 

Get the RX configuration IOCTL. 

Calls ifx_get_Rx_config(arg.chipld, 
arg.portld, &arg.L3Program, &arg.L3StartVld, 
&arg.L3Start); 

8.3.72 IFXSETQOS 

BUCKET 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_SET_QOS_BUCKET 

_IOW(IFX_IOC_MAGIC,1 28, 
QoSbucket_api) 

Set values for token bucket ID IOCTL. 

Calls ifx_set_QoS_bucket(arg.chipld, 
arg.tBucketld, arg.tBucketCnt, 
arg.tReplenishRateldx, arg.tBurstSizeldx); 


8.3.73 I FX_G ETQOSB U C KET 

Prototype 
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Parameters 



Data Type 

Name 

Description 

1 FX_G ET_QOS_BU CKET 

_IOR(IFX_IOC_MAGIC,129,Q 

oSbucket_api) 

Get values for token bucket ID IOCTL. 

Calls ifx_get_QoS_bucket(arg.chipld, 
arg.tBucketld, &arg.tBucketCnt, 
&arg.tReplenishRateldx, &arg.tBurstSizeldx); 

8.3.74 IFXSETQOS 

BUCKETFLOWCONTROL 

Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_SET_QOS_BUCKET_FL 

OWCONTROL 

_l 0 W( 1 FXJOCMAG 1 C , 1 30, 
QoSBflowCntr_api) 

Set flow control for token bucket ID IOCTL. 

Calls 

ifx_set_QoS_bucket_flow_control(arg.chipl 
d, arg.portRuleBaseldx, arg.actionLC, 
arg.actionNC); 


8.3.75 IFX_GET_QOS_BUCKET_FLOW_CONTROL 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_GET_QOS_BUCKET_FL 

OWCONTROL 

JOR(IFX_IOC_MAGIC,131,Q 

oSBflowCntr_api) 

Get flow control for token bucket ID IOCTL. 

Calls 

ifx_get_QoS_bucket_flow_control(arg.chipl 
d, &arg.portRuleBaseldx, &arg.actionLC, 
&arg.actionNC); 


8.3.76 I FXSETQOSWFQU E U E 

Prototype 


User’s Manual 
Programmer’s Reference 


95 


Revision 1.0, 2006-11-14 


INCA-IP2 

IP-Phone Solution, Linux® BSP Release 2.0 



CONFIDENTIAL Switch Access Interface 


Parameters 


Data Type 

Name 

Description 

IFX_SET_QOS_WF_QUEUE 

_IOW(IFX_IOC_MAGIC,132, 

QoSWFqueue_api) 

Set parameters for WFQ IOCTL. 

Calls ifx_set_QoS_WF_queue(arg.chipld, 
arg.portld, arg.queueld, arg.weightFactor, 
arg.deficitCount); 

8.3.77 

1 FX_GET_QOS_WF_QU E U E 


Prototype 




Parameters 




Data Type 

Name 

Description 

1 FX_G ET_QOS_WF_QUEUE 

IOR(l FX_I OC_M AG 1 C , 1 33, Q 

oSWFqueue_api) 

Get parameters for WFQ IOCTL. 

Calls ifx_get_QoS_WF_queue(arg.chipld, 
arg.portld, arg.queueld, &arg.weightFactor, 
&arg.deficitCount); 

8.3.78 

IFX_SET_QOS_SHAPING_QUEUE 


Prototype 




Parameters 




Data Type 

Name 

Description 

1 FX_SET_QOS_SHAPING_Q 
UEUE 

_IOW(IFX_IOC_MAGIC,134, 

QoSshapingQ_api) 

Set parameters for rate shaping IOCTL. 

Calls 

ifx_set_QoS_shaping_queue(arg.chipld, 
arg.portld, arg.queueld, arg.bucketCnt, 
arg.replenishRate, arg.tokenValue, 
arg.tReplenishTimer); 

8.3.79 

IFXGETQOS 

SHAPINGQUEUE 



Prototype 
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Parameters 



Data Type 

Name 

Description 

1 FX_G ET_QOS_SHAP INGQ 
UEUE 

_IOR(IFX_IOC_MAGIC,135,Q 

oSshapingQ_api) 

Get parameters for rate shaping IOCTL. 

Calls 

ifx_get_QoS_shaping_queue(arg.chipld, 
arg.portld, arg.queueld, &arg.bucketCnt, 
&arg.replenishRate, &arg.tokenValue, 
&arg.tReplenishTimer); 

8.3.80 IFXSETQOS 

REPLENISHRATE 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_SET_QOS_REPLENISH_ 

RATE 

_l O W( 1 FX_I OC_M AG 1 C , 1 36 , i 
dx_api) 

Set token bucket replenish rate IOCTL. 

Calls ifx_set_QoS_replenish_rate(arg.chipld, 
arg.ldx, arg.info); 


8.3.81 IFX_GET_QOS_REPLENISH_RATE 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_GET_QOS_REPLENISH_ 

RATE 

_IOR(IFX_IOC_MAGIC,137,id 

x_api) 

Get token bucket replenish rate IOCTL. 

Calls ifx_get_QoS_replenish_rate(arg.chipld, 
arg.ldx, &arg.info); 

8.3.82 IFXSETQOS 

BURSTSIZE 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_SET_QOS_BURST_SIZE 

_IOW(IFX_IOC_MAGIC,138,i 

dx_api) 

Set token bucket burst size IOCTL. 

Calls ifx_set_QoS_burst_size(arg.chipld, 
arg.ldx, arg.info); 
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8.3.83 I FX_G ET_QOS_B U RST_S IZE 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_QOS_BU RST_S IZE 

_IOR(IFX_IOC_MAGIC,139,id 

x_api) 

Get token bucket burst size IOCTL. 

Calls ifx_get_QoS_burst_size(arg.chipld, 
arg.ldx, &arg.info); 

8.3.84 IFXSETQOS 

EXTEND_BURST_SIZE 


Prototype 



Parameters 



Data Type 

Name 

Description 

1 FX_SET_QOS_EXTEND_B U 
RST_SIZE 

_IOW(IFX_IOC_MAGIC,140,i 

dx_api) 

Set token bucket extended burst size IOCTL. 
Calls 

ifx_set_QoS_exte n d_b u rst_s ize(a rg . ch ip 1 d , 
arg.ldx, arg.info); 


8.3.85 I FX_G ETQOSEXT E N D_B U RSTS IZ E 


Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_QOS_EXTE N D_B U 
RST_SIZE 

_IOR(IFX_IOC_MAGIC,141 ,id 
x_api) 

Get token bucket extended burst size IOCTL. 
Calls 

ifx_get_QoS_extend_burst_size(arg.chipld, 
arg.ldx, &arg.info); 


8.3.86 IFX_GET_RULE_MEM 

Prototype 
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Parameters 



Data Type 

Name 

Description 

1 FX_G ET RU LE M EM 

_IOR(IFX_IOC_MAGIC,144,ru 

le_mem_api) 

Get rule memory IOCTL. 

Calls ifx_get_rule_mem(arg.chipld, arg.bank, 
arg. address, arg. section, &arg.rule32_val); 


8.3.87 IFX_SET_INGRESS_WATERMARK 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_SET_INGRESS_WATER 

MARK 

_l 0 W( 1 FX_I OC_M AG 1 C , 1 84 , w 
atermark_api) 

Set Ingress watermark IOCTL. 

Calls ifx_set_ingress_watermark(arg.chipld, 
arg.waterMarkType, arg.portld, 
arg.waterMark); 


8.3.88 IFX_GET_INGRESS_WATERMARK 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_GET_INGRESS_WATER 

MARK 

_IOR(IFX_IOC_MAGIC,185,w 

atermark_api) 

Get Ingress watermark IOCTL. 

Calls ifx_get_ingress_watermark(arg.chipld, 
arg.waterMarkType, arg.portld, 

&arg.waterMark); 

8.3.89 IFX_SET_EGRESS_WATERMARK 


Prototype 



Parameters 



Data Type 

Name 

Description 

IFX_SET_EGRESS_WATERM 

ARK 

_IOW(IFX_IOC_MAGIC,186,E 

watermark_api) 

Set Egress watermark IOCTL. 

Calls ifx_set_egress_watermark(arg.chipld, 
arg.portld, arg.queueld, arg.waterMark); 
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8.3.90 IFX_GET_EGRESS_WATERMARK 

Prototype 


Infineon 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_EGRESS_WATER 
MARK 

_IOR(IFX_IOC_MAGIC,187,E 

watermark_api) 

Get Egress watermark IOCTL. 

Calls ifx_get_e g ress_wate r m a rk(arg.chipld, 
arg.portld, arg.queueld, &arg.waterMark); 


8.3.91 IFX_SET_TX_CONFIG 

Prototype 


Parameters 


Data Type 

Name 

Description 

IFX_SET_TX_CONFIG 

_IOW(IFX_IOC_MAGIC,188,T 

Set Tx config IOCTL. 


xConfig_api) 

Calls ifx_set_Tx_config(arg.chipld, arg.portld, 
arg.xmitDropCount, arg.lateCollisionCount); 


8.3.92 IFX_GET_TX_CONFIG 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_TX_C O N F 1 G 

_IOR(IFX_IOC_MAGIC,189,T 

Get Tx config IOCTL. 


xConfig_api) 

Calls ifx_get_Tx_config(arg.chipld, 



arg.portld, &arg.xmitDropCount, 



&arg.lateCollisionCount); 


8.3.93 IFX_SET_PORT_RATE_SHAPE 

Prototype 
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Parameters 



Data Type 

Name 

Description 

IFX_SET_PORT_RATE_SHA 

PE 

_l O W( 1 FX_I OC_M AG 1 C , 1 90 , r 
ateShape_api) 

Enable port rate shaping IOCTL. 

Calls ifx_set_PORT_rate_shape(arg.chipld, 
arg.en_dis, arg.PRE); 


8.3.94 IFX_GET_PORT_RATE_SHAPE 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_PORT_RATE_SH A 

_IOR(IFX_IOC_MAGIC,191,ra 

Get port rate shaping flag IOCTL. 

PE 

teShape_api) 

Calls ifxgetPO RTrates hape(arg.chipld, 
&arg.PRE); 


8.3.95 IFX_SET_PAUSE_FRAME_GEN 


Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_S ET_PAU S E_FRAM E_G 
EN 

_l O W( 1 FX_I OC_M AG 1 C , 1 92 , P 
auseFrame_api) 

Enable/Disable Pause Frame generation 

IOCTL. 

Calls ifx_set_pause_frame_gen(arg.chipld, 
arg.portld, arg.en_dis); 


8.3.96 IFX_GET_PAUSE_FRAME_GEN 

Prototype 


Parameters 


Data Type 

Name 

Description 

1 FX_G ET_P AU SE_F RAM E_G 
EN 

_IOR(IFX_IOC_MAGIC,193,P 

auseFrame_api) 

Get port rate shaping flag IOCTL. 

Calls ifx_get_pause_frame_gen(arg.chipld, 
arg.portld, &arg.en_dis); 


8.4 Structure Reference 

This chapter contains the structure reference. 
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Table 18 StructOverview 


Name 

Description 

cospr 

cos_pr IOCTL parameter struct. 

cos_rd 

cos_rd IOCTL parameter struct. 

cos_sel_reg_t 


cpuacsctrlregt 


dst_lookup_reg_t 


Ewatermark 

Ewatermark IOCTL parameter struct. 

featuremode 

set/get switch mode IOCTL parameter struct. 

Flagstat 

Flagstat IOCTL parameter struct. 

flowld 

flowld IOCTL parameter struct. 

flowParam 

flowParam IOCTL parameter struct. 

flowPattern 

flowPattern IOCTL parameter struct. 

gmac_reg_t 


idx 

idx IOCTL parameter struct. 

malearnregt 


macAging 

macAging IOCTL parameter struct. 

macTenldx 

macTenldx IOCTL parameter struct. 

macTidx 

macTidx IOCTL parameter struct. 

macTstat 

macTstat IOCTL parameter struct. 

mdiomode 


mib_idx 

mibjdx IOCTL parameter struct. 

mibCounters 

mibCounters IOCTL parameter struct. 

PauseFrame 

Pause Frame Generation IOCTL parameter struct. 

PHY_REG0_T 


PHYREG4T 


PHYREG9T 


phyAction 

phyAction IOCTL parameter struct. 

pmachdctlregt 


pmacvlan 

vlanjdx IOCTL parameter struct. 

pmac_vlan_reg_t 


port_eth_conf 

Port Ethernet Configuration IOCTL parameter struct. 

port_pause_ctl_reg_t 


portrxwmregst 


port_status_per_vlan 


po rttxwmregOt 


po rt tx wm regl t 


portC oS 

portCoS IOCTL parameter struct. 

portKey 

portKey IOCTL parameter struct. 

portMode 

portMode IOCTL parameter struct. 

portOffset 

portOffset IOCTL parameter struct. 

portRule 

portRule IOCTL parameter struct. 
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Table 18 StructOverview (cont’d) 


Name 

Description 

portVIan 

portVIan IOCTL parameter struct. 

prctrlregt 


pri2_cos_reg_t 


QoSBflowCntr 

QoSBflowCntr IOCTL parameter struct. 

QoSbucket 

QoSbucket IOCTL parameter struct. 

QoSshapingQ 

QoSshapingQ IOCTL parameter struct. 

QoSWFqueue 

QoSWFqueue IOCTL parameter struct. 

rateShape 

rateShape IOCTL parameter struct. 

rtxisrregt 


rule_mem 

rule_mem IOCTL parameter struct. 

rx_config_reg_t 


RxConfig 

RxConfig IOCTL parameter struct. 

sdcmdregt 


sddataregOt 


sd_data_reg1_t 


sd_data_reg2_t 


switchapicommand 


tb_ctrl_reg_t 


tx_config_reg_t 


TxConfig 

TxConfig IOCTL parameter struct. 

ucast_fid 

xcast_fid IOCTL parameter struct. 

vlan_aware 

vlan_aware IOCTL parameter struct. 

vlanidx 

vlanjdx IOCTL parameter struct. 

vlanmibscmdregt 


vlan_status 

vlan_status IOCTL parameter struct. 

vlan_tableentry 

vlan_tableentry IOCTL parameter struct. 

vlantblcmdregt 


vlan_tbl_data_t 


watermark 

watermark IOCTL parameter struct. 


8.4.1 cos_pr 


Description 

cos_pr IOCTL parameter struct. 

Used by: 

• IFX_MAP_INGRESS_PRIORITY_COS 

• IFX_GET_INGRESS_PRIORITY_COS 

• IFX_MAP_COS_EGRESS_PRIORITY 

• IFX_GET_COS_EGRESS_PRIORITY 

Prototype 


'Infineon 
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Parameters 



Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

Priority 

IngressPriority (0-7). 

u32 

CoS 

Class of service (0-3). 


Description 

cos_rd IOCTL parameter struct. 
Used by: 

• IFX_MAP_COS_REDUCTION 

• IFX_GET_COS_REDUCTION 


Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

reduction 

Reduced class of service (0-3). 

u32 

CoS 

Class of service (0-3). 


8.4.3 cos_sel_reg_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

Cr3 


u32 

Cr2 


u32 

Crl 


u32 

CrO 


u32 

CpO 


u32 

CpI 


u32 

Cp2 


u32 

Cp3 
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8.4.4 cpu_acs_ctrl_reg_t 

Description 


'Infineon 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

Table_sel 


u32 

Index 


u32 

Table_specific 


u32 

Read_write 


u32 

Req_ack 



8.4.5 dst_lookup_reg_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsvl 


u32 

En_ma_read 


u32 

EnjnaJearn 


u32 

En_da_lookup 


u32 

Rsv2 


u32 

Da_state 


u32 

Rsv3 


u32 

Dst 


u32 

Da_crit 


u32 

Rsv4 



8.4.6 Ewatermark 


Description 

Ewatermark IOCTL parameter struct. 
Used by: 


User’s Manual 
Programmer’s Reference 


105 


Revision 1.0, 2006-11-14 


INCA-IP2 

IP-Phone Solution, Linux® BSP Release 2.0 

CONFIDENTIAL Switch Access Interface 

• IFX_SET_EGRESS_WATERMARK 

• IFX_GET_EGRESS_WATERMARK 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC 2=CPU. 

u32 

queueld 

Queue ID (0-3). 

u32 

waterMark 

Watermark value. 


8.4.7 feature_mode 


Description 

set/get switch mode IOCTL parameter struct. 
Used by: 

• IFX_SET_SWITCH_MODE 

• IFX_GET_SWITCH_MODE 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

feature 

2 - GE_MCASTQ_THRESHOLD 6 - 
AGING_SOURCE 7 - AGING_TIME_SELECT 

8 - MA_FREEZE_ALL 9 - MA_FREEZE_NEW 
10 - CRCERROR_PACKET_MONITOR 11 - 
MACHANGE_PACKET_MONIOR 12 - 
PAUSE_PACKET_TO_CPU 13- 
FORWARD_CFI_PACKET 14 - 
MA_REPLACE_THRESHOLD 33 - 
UNKNOWN PROTOCOL TO CPU 34 - 
MONITORINGPORT 

u32 

mode 



8.4.8 Flagstat 


Description 

Flagstat IOCTL parameter struct. 
Used by: 
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• IFX_SET_INGRESS_MONITOR_FLAG 

• IFX_GET_INGRESS_MONITOR_FLAG 

• IFX_SET_EGRESS_MONITOR_FLAG 

• IFX_GET_EGRESS_MONITOR_FLAG 

• IFX_SET_PORT_LOCK 

• IFX_GET_PORT_LOCK 

• IFX_SET_PORT_INGRESS_VLAN_TAG 

• IFX_GET_PORT_INGRESS_VLAN_TAG 

• IFX_SET_PORT_INGRESS_VLAN_FILTER 

• IFX_GET_PORT_INGRESS_VLAN_FILTER 

• IFX_SET_PORT_JUMBO_ENABLE 

• IFX_GET_PORT_JUMBO_ENABLE 


'Infineon 


Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC2=CPU. 

BOOL 

flag 

TRUE or FALSE. 


8.4.9 flowld 


Description 

flowld IOCTL parameter struct. 

Used by: 

• IFX_DELETE_FLOW_PATTERN 
Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

flowld 

Flow ID (0-23). 


8.4.10 flowParam 


Description 

flowParam IOCTL parameter struct. 

Used by: 

• IFX_SET_FLOW_ACTION_PARAM 

• IFX_GET_FLOW_ACTION_PARAM 

• IFX_DELETE_FLOW_ACTION_PARAM 
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Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

flowld 

Flow ID (0-23). 

u32 

feature 

Possible Features. 

• REDIRECTMCAST : 

bit 2 = LAN Portbit 1 = PC Portbit 0 = CPU 
port 

• MIRROR: 

1 = Mirror EnableO = Mirror Disable 

• COS_ASSIGNMENT : 

0-3 CoS Value to be assigned to this rule. 

• VLAN_ASSIGNMENT : 

0-4094 VLAN value to be associated for this 
rule. 

• TKN_BKT_ID: 

0-62 Token bucket ID for this rule.63 Token 

bucket ID is flow ID 

• DELETE_ACTION_ENTRY : (valid only for 

1 FX_D E LETE_FLO W_ACT 1 0 N_P AR AM ) 
removes the entry assigned by flowld from 
the action table. 

u32 

flowAction 

Action value for the selected feature. 


8.4.11 flowPattern 

Description 

flowPattern IOCTL parameter struct. 
Used by: 

• IFX_SET_FLOW_PATTERN 

• IFX_GET_FLOW_PATTERN 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

flowld 

Flow ID (0-23). 

u32 

1 Key Data [4] 

Rule vector (0-127). 

u32 

IKeyMask[4] 

Mask vector (0-127). 
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8.4.12 gmac_reg_t 

Description 


'Infineon 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsvl 


u32 

Lipg 


u32 

Rsv2 


u32 

tpe 


u32 

rpe 


u32 

ig 


u32 

dg 


u32 

sg 


u32 

g_sel 



8.4.13 idx 


Description 

idx IOCTL parameter struct. 

Used by: 

• IFX_SET_QOS_REPLENISH_RATE 

• IFX_GET_QOS_REPLENISH_RATE 

• IFX_SET_QOS_BURST_SIZE 

• IFX_GET_QOS_BURST_SIZE 

• I FX_S ET_QOS_EXTE N D_B U RST_S I Z E 

• IFX_GET_QOS_EXTEND_BURST_SIZE 


Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

Idx 

Index to replenish rate register. 

u32 

info 

Replenish rate value. 
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8.4.14 ma_learn_reg_t 

Description 


'Infineon 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsvl 


u32 

Ma_state 


u32 

Rsv2 


u32 

Ma_dest 


u32 

MA_crit 


u32 

Rsv3 



8.4.15 macAging 


Description 

macAging IOCTL parameter struct. 

Used by: 

• IFX_CONTROL_MAC_TABLE_AGING 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

aging_period 

MAC table aging period. 


8.4.16 macTenldx 


Description 

macTenldx IOCTL parameter struct. 

Used by: 

• IFX_ADD_MAC_TABLE_ENTRY 

• IFX_GET_MAC_TABLE_ENTRY_IDX 

Prototype 
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Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

macTablelndex 

MAC table index (0-63). 

u8 

macAddr[6] 

MAC address macAddrPtr[0] -> MAC address 
byte 5 macAddrPtr[1] -> MAC address byte 4 
macAddrPtr[2] -> MAC address byte 3 
macAddrPtr[3] -> MAC address byte 2 
macAddrPtr[4] -> MAC address byte 1 
macAddrPtr[5] -> MAC address byte 0. 

BOOL 

lan_port 

LAN port assignment -> FALSE: not assigned, 
TRUE: assigned. 

BOOL 

pc_port 

PC port assignment -> FALSE: not assigned, 
TRUE: assigned. 

BOOL 

cpu_port 

CPU port assignment -> FALSE: not assigned, 
TRUE: assigned. 

BOOL 

criticalFlag 

Priority Status of the packet 0: normal, 

1 critical. 

u32 

maState 

aging status: 0(static),1. 

..14(dynamic),15(aged out) 


8.4.17 macTidx 

Description 

macTidx IOCTL parameter struct. 
Used by: 

• I FX_GET_MAC_TABLE_I DX 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

macAddr[6] 

MAC address macAddrPtr[0] -> MAC address 
byte 5 macAddrPtr[1] -> MAC address byte 4 
macAddrPtr[2] -> MAC address byte 3 
macAddrPtr[3] -> MAC address byte 2 
macAddrPtr[4] -> MAC address byte 1 
macAddrPtr[5] -> MAC address byte 0. 

u32 

tablelndex 

MAC table index (0-63). 


8.4.18 macTstat 

Description 

macTstat IOCTL parameter struct. 
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Used by: 

• IFX_GET_MAC_TABLE_STAT 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

staticCount 

Number of static entries. 

u32 

valid 

Number of valid entries. 


8.4.19 mdiomode 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

port_group 


BOOL 

mdioMode 


BOOL 

autoNegMode 



8.4.20 mibidx 


Description 

mibjdx IOCTL parameter struct. 
Used by: 

• I FX_GET_VLAN_M I B 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

mibidx 

VLAN Index (0-63). 
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Data Type 

Name 

Description 

u32 

counterld 

Counter ID 0=Byte counter, 1=Packet counter, 



2=Dropped packet counter, 3=Non unicast 



packet counter. 

u32 

count 

Counter value. 


8.4.21 mibCounters 

Description 

mibCounters IOCTL parameter struct. 
Used by: 

• I FX_G ET_PORT_M I B_COU NTERS 

• I FX_GET_M AC_M I B_COU NTERS 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC 2=CPU. 

u32 

counterld 

Port MIB counter ID 

(IFX_GET_PORT_MIB_COUNTERS) 0 - rx 
Bytes; 1 - rx Unicast Packets 2 - rx Broadcast 
Packets 3 - rx Multicast Packets 4 - rx CRC 

Errored Packets 5 - rx Undersized Good 

Packets 6 - rx Undersized Errored Packets 7 - 
rx Packets with length <= 64 Byte 8 - rx Packets 
with 64 byte < length <= 127 byte 9 - rx Packets 
with 127 byte < length <= 255 byte 10 - rx 
Packets with 255 byte < length <= 51 1 byte 1 1 

- rx Packets with 51 1 byte < length <= 1023 
byte 12 - rx Packets with 1023 byte < length <= 
MAXPKTLEN byte 13 - rx Oversized Good 
Packets (Packet length > MAX PKT LEN 
bytes) 14 - rx Oversized Bad Packets (Packet 
length > MAX_PKT_LEN bytes) 15 - rx Good 
Pause Packets 16 - rx Dropped Packets 17 - tx 
Bytes 18 - tx Unicast Pkts 19 - tx Broadcast 

Pkts 20 - tx Multicast Pkts. 

MAC MIB counter ID 

( 1 FX_G ET_M AC M 1 B_COU NTERS) 0 - tx 
Pause Frames 1 - tx single Collisions 2 - tx 
multiple Collisions 3 - tx Excessive Collisions 4 

- tx Later Collisions 5 - tx deferred 

u32 

count 

Value of MIB counter. 
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8.4.22 PauseFrame 

Description 

Pause Frame Generation IOCTL parameter struct. 

Used by: 

• I FX_S ET_P AU S E_F RAM E_G E N 

• I FX_G ET_P AU S E_FRAM E_G E N 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC. 

BOOL 

en_dis 

Enable/disable pause frame generation (0- 
disable, 1-enable). 


8.4.23 PHY_REG0_T 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u16 

reset 


u16 

loop_back 


u16 

speed_sel 


u16 

auto_nego_enable 


u16 

power_down 


u16 

isolate 


u16 

restart_auto_nego 


u16 

duplex_mode 


u16 

reserv 



8.4.24 PHY_REG4_T 

Description 
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Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

u16 

next_page 


u16 

reserved2 


u16 

remote_fault 


u16 

reserved 1 


u16 

pause 


u16 

T4_100 


u16 

fulMOO 


u16 

half_1 00 


u16 

fulMO 


u16 

half_10 


u16 

selector_field 



8.4.25 PHY_REG9_T 

Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u16 

test_mode 


u16 

master_slave_enable 


u16 

master_slave_conf 


u16 

port_type 


u16 

fulMOOO 


u16 

half_1000 


u16 

reserv 



8.4.26 phyAction 


Description 

phyAction IOCTL parameter struct. 
Used by: 

• IFX_PHY_READ 

• IFX_PHY_WRITE 


User’s Manual 
Programmer’s Reference 


115 


Revision 1.0, 2006-11-14 


INCA-IP2 

IP-Phone Solution, Linux® BSP Release 2.0 

CONFIDENTIAL Switch Access Interface 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

uint 

chipld 

ChipID (always 0). 

u8 

mdiojd 

MDIO ID. 

u8 

phy_addr 

MDIO address of the PHY device. 

u8 

RegOffset 

PHY register address. 

u16 

Data 

Register data. 


8.4.27 pmac_hd_ctl_reg_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

rem_L2_hd 


u32 

rem_crc 


u32 

add_stat_hd 


u32 

add_crc 


u32 

typejen 


u32 

add_tag 


u32 

add_eth_hd 



8.4.28 pmac_vlan 

Description 

vlanjdx IOCTL parameter struct. 
Used by: 

• IFX_GET_VLANJDX 

Prototype 
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Parameters 



Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

BOOL 

en_dis 

0- disable, 1-enable tag insertion 

u32 

Vlanld 

VLANID (1-4094). 

u8 

prio 

Priority (0-7). 

u8 

cfi 

canonical format indicator, 0-little endian, 1-big 
endian 


8.4.29 pmac_vlan_reg_t 

Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

pri 


u32 

cfi 


u32 

vlanjd 



8.4.30 port_eth_conf 


Description 

Port Ethernet Configuration IOCTL parameter struct. 
Used by: 

• IFX_SET_PORT_ETH_CONF 

• IFX_GET_PORT_ETH_CONF 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC. 

u32 

speed 

0-10Mbit/s, 1 -1 OOMbit/s, 2-1000Mbit/s 

u32 

duplex 

half(0) or full duplex mode(1 ) 

BOOL 

autoneg 

disable(O) or enable(l) autonegotiation 
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Data Type 

Name 

Description 

u32 

int_ext_phy 

use internal(O) or external(l) PHY 

u32 

link_status 

link down(0) or link up(1 ) only for 
IFX_GET_PORT_ETH_CONF 

8.4.31 port_pause_ctl 

_reg_t 



Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

pfg_pc 


u32 

pfgjan 



8.4.32 port_rx_wm_regs_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

rx_wm2 


u32 

rx_wm1 



8.4.33 port_status_per_vlan 


Description 


Prototype 
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Data Type 

Name 

Description 

u8 

vlanmember 


u8 

portstate 


u8 

Rsv 



8.4.34 porttxwmregOt 

Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

Queue1_tx_wm 


u32 

QueueO_tx_wm 



8.4.35 port_tx_wm_reg1_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

Queue3_tx_wm 


u32 

Queue2_tx_wm 



8.4.36 portCoS 


Description 

portCoS IOCTL parameter struct. 
Used by: 

• I FX_SET_PORT_COS 

• IFX_GET_PORT_COS 
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Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC2=CPU. 

u32 

CoS 

Class of service (0-3). 


8.4.37 portKey 

Description 

portKey IOCTL parameter struct. 
Used by: 

• I FX_SET_PORT_KE Y 

• IFX_GET_PORT_KEY 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC2=CPU. 

u32 

IKey 

IKEY value. 


8.4.38 portMode 

Description 

portMode IOCTL parameter struct. 
Used by: 

• IFX_SET_PORT_FE_MODE 

• IFX_GET_PORT_FE_MODE 

• IFX_SET_PORT_GE_MODE 

• IFX_GET_PORT_GE_MODE 


Prototype 
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Parameters 


'Infineon 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC. 

u32 

feature 

Port feature to be configured/read (see mode 
descr. 

) 

u32 

mode 

Feature related modes: Fast Ethernet(FE): 0 - 
FE/GE_PORT_AUTONEGOTIATION 0 - 
disable autonegotiation 1 - enable 
autonegotiation 1 - FE/GE_PORT_LINK_OK 
(only IFX_GET_PORT_FE_MODE) 0 - link 
down 1 - link up 2 - 

FE/GE_PORT_DUPLEX_MODE 0 - half 
duplex 1 - full duplex 3 - 
F E/G E_PO RT_S PEED 0-10 MBit/s 1-100 
MBit/s 2-1 GBit/s (only in GE mode) 4 - 
FE/GE_PORT_PAUSE_FLOW_CTRL 0 - 
disable flow control 1 - enable flow control 5 - 
FE/GE_PORT_PRIORITY 0. 

..3 - lowest.. .highest prio cos 6 - 
FE/GE_PORT_MONITOR_INGRESS 0 - 
disable ingress monitoring for port 1 - enable 
ingress monitoring for port 7 - 
FE/GE_PORT_MONITOR_EGRESS 0 - 
disable egrress monitoring for port 1 - enable 
egress monitoring for port 8 - 
FE/GE_PORT_AUTHENTICATION 0 - not 
authorized to receive or transmit 1 - authorized 
to transmit but not to receive 2 - authorized to 
receive but not to transmit 3 - authorized to 
transmit and receive 


8.4.39 portOffset 

Description 

portOffset IOCTL parameter struct. 
Used by: 

• IFX_SET_PORT_OFFSET 

• IFX_GET_PORT_OFFSET 

Prototype 
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Parameters 



Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC 2=CPU. 

u32 

portOffset[2] 

Port Offset 0. 

..7 


8.4.40 portRule 


Description 

portRule IOCTL parameter struct. 
Used by: 

• IFX_SET_PORT_RULE 

• IFX_GET_PORT_RULE 

• IFX_SET_PORT_MASK 

• IFX_GET_PORT_MASK 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC2=CPU. 

u32 

portRule[4] 

128 bit port rule 


8.4.41 portVIan 


Description 

portVIan IOCTL parameter struct. 
Used by: 

• I FX_SET_PORT_VLAN I D 

• I FX_GET_PORT_V LAN I D 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC2=CPU. 

u32 

vlanid 

VLANID (1-4094). 
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8.4.42 pr_ctrl_reg_t 

Description 


'Infineon 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsvl 


u32 

MA_Replace_Threshold 


u32 

Fwd_unknown2_cpu 


u32 

Fwd_cfi_pkts 


u32 

Fwd_pause2cpu 


u32 

Monitor_MA_change_pkt 


u32 

Monitor_crc 


u32 

MA_Freez_New 


u32 

MA_Freeze 


u32 

AgeTimer 


u32 

Age_tick_Sw 


u32 

Send_Res2_cpu 


u32 

Rsv2 


u32 

ge_bcastq_threshold 


u32 

Rsv3 



8.4.43 pri2_cos_reg_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

Pc7 


u32 

Pc6 


u32 

Pc5 


u32 

Pc4 


u32 

Pc3 
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Data Type 

Name 

Description 

u32 

Pc2 


u32 

Pci 


u32 

PcO 



8.4.44 QoSBflowCntr 

Description 

QoSBflowCntr IOCTL parameter struct. 

Used by: 

• IFX_SET_QOS_BUCKET_FLOW_CONTROL 

• IFX_GET_QOS_BUCKET_FLOW_CONTROL 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portRuleBaseldx 

Port Rule base Id (0-511). 

u32 

actionLC 

Flow Control Action for loosley confirming 
packets. 

u32 

actionNC 

Flow Control Action for non confirming packets. 


8.4.45 QoSbucket 


Description 

QoSbucket IOCTL parameter struct. 
Used by: 

• IFX_SET_QOS_BUCKET 

• IFX_GET_QOS_BUCKET 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

tBucketld 

Token Bucket ID (0-63). 

u32 

tBucketCnt 

32bit Bucket count 

u32 

tReplenishRateldx 

Replinish Rate. 

u32 

tBurstSizeldx 

Index of Replinish Rate register. 
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8.4.46 QoSshapingQ 

Description 

QoSshapingQ IOCTL parameter struct. 

Used by: 

• I FX_SET_QOS_S H AP I N G_QU E U E 

• I FX_G ET_QOS_S H AP I N G_QU E U E 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC 2=CPU. 

u32 

queueld 

Queue ID (0-3). 

u32 

bucketCnt 

21 bit Bucket count for rate shaping 

u32 

replenishRate 

20 bit Replinish rate for rate shaping 

u32 

tokenValue 

20 bit Token value for rate shaping 

u32 

tReplenishTimer 

Replinish rate timer for rate shaping. 


8.4.47 QoSWFqueue 


Description 

QoSWFqueue IOCTL parameter struct. 
Used by: 

• I FX_SET_QOS_WF_QU EUE 

• I FX_GET_QOS_WF_QU EUE 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC2=CPU. 

u32 

queueld 

Queue ID (0-3). 

u32 

weightFactor 

16 bit Weight Factor associated with each 
queue for WFQ scheduling 

u32 

deficitCount 

21 bit DeficitCount for WFQ scheduling 
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8.4.48 rateShape 

Description 

rateShape IOCTL parameter struct. 

Used by: 

• IFX_SET_PORT_RATE_SHAPE 

• IFX_GET_PORT_RATE_SHAPE 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

BOOL 

en_dis 

rate shaping enable(1)/disable(0) flag 

BOOL 

PRE 

Port rate shaping enable flag. 


8.4.49 rtx_isr_reg_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

txma 

Tx Maximum Attempts Interrupt. 

u32 

txlc 

Tx Late Collision Interrupt. 

u32 

txec 

Tx Early Collision Interrupt. 

u32 

txuf 

Transmit Underflow Interrupt. 

u32 

rr 

Rkey received Interrupt. 

u32 

noeof 

No EOF detected Interrupt. 

u32 

nosof 

No SOF detected Interrupt. 

u32 

rxfo 

Receive FIFO overflow Interrupt. 

u32 

rxce 

Receive CRC Error Interrupt. 

u32 

rxnrc 

No RxD Cell in Receive Interrupt. 

u32 

rxnpd 

No Packet Descriptor available Interrupt. 

u32 

rxnpn 

No PBNUM available Interrupt. 
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8.4.50 rulemem 

Description 

rule_mem IOCTL parameter struct. 

Used by: 

• IFX_GET_RULE_MEM 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

bank 


u32 

address 


u32 

section 


u32 

rule32_val 



8.4.51 rx_config_reg_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

L3 Prog ram 


u32 

L3StartVld 


u32 

L3Start 


u32 

Res 



8.4.52 RxConfig 

Description 

RxConfig IOCTL parameter struct. 
Used by: 

• I FX_SET_RX_CON F IG 

• I FX_G ET_RX_C O N F I G 

Prototype 
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Parameters 


'Infineon 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC2=CPU. 

BOOL 

L3 Prog ram 


BOOL 

L3StartVld 

Layer3 start valid flag. 

u32 

L3Start 

Layer3 start value in bytes. 


8.4.53 sdcmdregt 

Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Req_ack 


u32 

Read_write 


u32 

Resl 


u32 

field_sel 


u32 

Queuejd 


u32 

Res2 


u32 

Port_id 



8.4.54 sd_data_regO_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Replinish_rate 


u32 

Token_val 
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8.4.55 sd_data_reg1_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Weight 


u32 

Bucket_cnt 


u32 

Replinish_rate 



8.4.56 sd_data_reg2_t 

Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Replinish_timer 


u32 

Deficit_cnt 


u32 

Weight 



8.4.57 switch_api_command 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

const char * 

name 


const void * 

function 


const char * 

pa ram 
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8.4.58 tb_ctrl_reg_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

rule_base_idx 


u32 

actionNC 


u32 

actionLC 



8.4.59 tx_config_reg_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Rsv 


u32 

Attemptjimit 


u32 

late_coll_thresh 



8.4.60 TxConfig 


Description 

TxConfig IOCTL parameter struct. 
Used by: 

• IFX_SET_TX_CONFIG 

• IFX_GET_TX_CONFIG 

Prototype 
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Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

portld 

PortID 0=LAN 1=PC 2=CPU. 

u32 

xmitDropCount 

Number of retransmission attempts before the 
packet is discarded. 

u32 

lateCollisionCount 

Threshold of decision between Early and Late 
collision. 


8.4.61 ucast_fid 

Description 

xcast_fid IOCTL parameter struct. 

Used by: 

• IFX_SET_UNKNOWN_UCAST_ID 

• I FX_G ET_U N KN O WN_U C AST_I D 

• IFX_SET_UNKNOWN_MCAST_ID 

• I FX_G ETUNKNOW N_M CASTI D 

• I FX_S ETB C AST_I D 

• I FX_GET_BCAST_I D 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

flood Id 



8.4.62 vlanaware 

Description 

vlan_aware IOCTL parameter struct. 
Used by: 

• I FX_SET_VLAN_AWARE 

• I FX_GET_VLAN_AWARE 

Prototype 
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Parameters 



Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

BOOL 

VlanAwareFlag 

TRUE=enable VLAN awareness, 
FALSE=disable. 


8.4.63 vlanidx 

Description 

vlanjdx IOCTL parameter struct. 
Used by: 

• IFX_GET_VLAN_IDX 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

Vlanld 

VLANID (1-4094). 

u32 

Vlanlndex 

VLAN Index (0-63). 


8.4.64 vlan_mibs_cmd_reg_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Req_ack 


u32 

Read_write 


u32 

MIBId 


u32 

Reservd 


u32 

Address 



8.4.65 vlan_status 

Description 

vlan_status IOCTL parameter struct. 
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Used by: 

• IFX_VLAN_CHECK 

Prototype 


'Infineon 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

vlanld 

VLANID (1-4094). 

BOOL 

flag 

TRUE=created, FALSE=not created. 


8.4.66 vlan_tableentry 


Description 

vlan_tableentry IOCTL parameter struct. 
Used by: 

• IFX_ADD_VLAN_TABLE_ENTRY 

• IFX_GET_VLAN_TABLE_ENTRY 

• IFX_DEL_VLAN_TABLE_ENTRY 

Prototype 


Parameters 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

vlanld 

VLANID (1-4094). 

u32 

portmemberList[2] 

Port Membership -> 0:Not a 

member, 1:Member (Bit 0=LAN port, bit 1=PC 

port, bit 2=CPU port). 

u32 

portegressList[2] 

Port Egress Tagging -> 0:do not tag 
packet, 1:tag packet. 

BOOL 

valid 

Entry-valid-flag -> 0:table entry invalid, 1:table 
entry valid. 


8.4.67 vlan_tbl_cmd_reg_t 


Description 


Prototype 
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Parameters 


'Infineon 


Data Type 

Name 

Description 

u32 

Req_ack 


u32 

Read_write 


u32 

Reservd 


u32 

Vlanjd 



8.4.68 vlan_tbl_data_t 


Description 


Prototype 


Parameters 


Data Type 

Name 

Description 

u32 

Reservd 


u32 

valid 


u32 

egr_cpu 


u32 

egr_pc 


u32 

egrjan 


u32 

member_cpu 


u32 

member_pc 


u32 

memberjan 


u32 

Vlanjd 



8.4.69 watermark 


Description 

watermark IOCTL parameter struct. 

Used by: 

• IFX_SET_INGRESS_WATERMARK 

• IFX_GET_INGRESS_WATERMARK 

Prototype 
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Parameters 


'Infineon 


Data Type 

Name 

Description 

u8 

chipld 

ChipID (always 0). 

u32 

waterMarkType 

Type of watermark 

1 =GLOBAL_DROP_WATERMARK,2=PORTG 
ROUP_FC_WATERMARK,3=PORTGROUP_ 
DROP_WATERMARK. 

u32 

portld 

PortID 0=LAN 1=PC2=CPU. 

u32 

waterMark 

Watermark value. 
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9 


Pseudo LAN Driver 


The pseudo Ian driver allows easy access to PC- and LAN-port PHYs of the INCA-IP2. It allows to query the 
current configuration, to set the advertisement configuration or to force a specific configuration with help of the mii- 
tool which can be downloaded from http://wiki.metux.de/public/mii-tool . 

Two network devices are created, which support only the ioctls needed by mii-tool. No data transfer is possible via 
these interface. The network interfaces are named “incaip2_pc” for the PC PHY and “incaip2_lan” for the LAN 
PHY. 

Usage of the mii-tool is: 

• mii-tool incaip2_pc 

This shows the current link status of the PC PHY 

• mii-tool -A 100BaseTX incaip2_lan 

This programs the advertising register of the LAN PHY to allow only lOOMBit/s connections during auto- 
negotiation. 

For further information have a look at the man-page of the mii-tool. 

The pseudo Ian driver source can be found under source/kernel/ifx/bsp/arch/mips/infineon/incaip2/pseudo_lan 
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10 Crypto Engine Driver 

The INCA-IP2 device provides hardware support for chiper (AES.DES/3DES) and digest (SHA1,MD5) algorithms 
and allows to prioritize voice against other data. Furthermore the cryptographic processing can be done with DMA 
support. Figure 3 shows a functional representation of the HW modules involved in the encryption process. 


'Infineon 



DEU_SCENARIO 

Figure 3 Architecture Overview 

As shown in Figure 3 only the main processor has access to the Data Encryption Unit (DEU). 

The Crypto Engine Driver supports the complete hardware feature set and provide convenient kernel functions 
that can be used by the application software in order to realize the required security application. 

The crypto API of the Linux kernel 2.4.31 offers cryptographic support, which is also used by the Crypto Engine 
Driver, in order to keep the effort on application developpment side at a minimum. This makes it possible to reuse 
security applications running ontop of the crypto API. 

In addition to the crypto API functionality, the Crypto Engine Driver supports all chaining modes 
(ECB,CBC,OFB,CFB). 

10.1 API Reference 

This chapter describe the kernel interface functions used for the cryptographic processing. 

10.1.1 crypto_alloc_tfm 

Description 

This function will first attempt to locate an already loaded algorithm. If that fails and the kernel supports dynamically 
loadable modules, it will then attempt to load a module of the same name or alias. This function has the same 
function interface as the crypto_alloc_tfm function defined in the api.c of the Linux kernel 2.6.11 
(http://lxr.linux.no/sou rce/crypto/api.c?a=mips). 
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10.1.2 crypto_digest_init 

Description 

This function has the same functionality and the same function interface as the crypto_digest_init function 
defined in the crypto. h of the Linux kernel 2.6.11 (http://lxr.linux.no/source/include/linux/crypto. h?a=mips). 

10.1.3 crypto_digest_update 

Description 

This function has the same functionality and the same function interface as the crypto_digest_update function 
defined in the crypto. h of the Linux kernel 2.6.11 (http://lxr.linux.no/source/include/linux/crypto. h?a=mips). 

10.1.4 crypto_digest_final 

Description 

This function has the same functionality and the same function interface as the crypto_digest_final function 
defined in the crypto. h of the Linux kernel 2.6.11 (http://lxr.linux.no/source/include/linux/crypto. h?a=mips). 

10.1.5 crypto_cipher_setkey 

Description 

This function has the same functionality and the same function interface as the crypto_cipher_setkey function 
defined in the crypto. h of the Linux kernel 2.6.11 (http://lxr.linux.no/source/include/linux/crypto. h?a=mips). 

10.1.6 crypto_cipher_set_iv 

Description 

This function has the same functionality and the same function interface as the crypto_cipher_set_iv function 
defined in the crypto. h of the Linux kernel 2.6.11 (http://lxr.linux.no/source/include/linux/crypto. h?a=mips). 

10.1.7 crypto_tfm_alg_ivsize 

Description 

This function has the same functionality and the same function interface as the crypto_tfm_alg_ivsize function 
defined in the crypto. h of the Linux kernel 2.6.11 (http://lxr.linux.no/source/include/linux/crypto. h?a=mips). 

10.1.8 crypto_chiper_encrypt 

Description 

This function has the same functionality and the same function interface as the crypto_chiper_encrypt function 
defined in the crypto. h of the Linux kernel 2.6.11 (http://lxr.linux.no/source/include/linux/crypto.h?a=mips). 

10.1.9 crypto_chiper_decrypt 

Description 

This function has the same functionality and the same function interface as the crypto_chiper_decrypt function 
defined in the crypto. h of the Linux kernel 2.6.11 (http://lxr.linux.no/source/include/linux/crypto. h?a=mips). 
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10.1.10 crypto_alg 

Description 

Structure used by the function crypto_alloc_tfm. This structure replaces the crypto_alg structure defined in the 
crypto. h of the Linux kernel 2.6.11 (http://lxr.linux.no/source/include/linux/crypto. h?a=mips). The enhanced IFX 
structure adds support for different transfer modes and priorities. This chapter describes only the new parameters. 

Prototype 

typedef struct 
{ 

struct list_head cra_list; 
u32 cra_flags; 

unsigned char ifx_transfer_mode; 
unsigned char ifx priority; 
unsigned int cra_blocksize; 
unsigned int cra_ctxsize; 

const char cra_name [CRYPTO_MAX_ALG_NAME] ; 
unsigned int cra_preference; 


union { 

struct cipher_alg cipher; 
struct digest_alg digest; 
struct compress_alg compress; 
} cra_u ; 


struct module *cra_module; 
}crypto_alg; 


Parameters 


Data Type 

Name 

Description 

unsigned char 

ifx_transfer_mode 

0 D DMA, involve DMA for data transfer 

1 D FPI, FPI bus is used for data transfer 

unsigned char 

ifx priority 

0 D STANDARD, priority used for ordinary 
data encryption 

1 D HIGH, priority used for voice data 
encryption 
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11 USB Support 


With the release of the 2.4 Linux kernel USB support was integrated. The Linux USB subsystem supports 
Universal Host Controller Interface (UHCI) and Open Host Controller Interface (OHCI). The INCA-IP2 device 
includes a USB implementation based on the Open Host Controller Interface (OHCI) and therefore allows the use 
of the generic OHCI driver provided in the kernel. 

The USB stack provides support for USB Human Interface Device class, which includes keyboards, mice, 
touchpads, joysticks and graphics tablets. In addition the USB stack provides also support for Printer class, Audio 
class and Mass Storage class. 

For example to enable USB support for Audio class the following commands can be used: 

root@host> insmod usbcore 
root@host> insmod incaip2_usb 
root@host> insmod soundcore 
root@host> insmod audio 

More information about using the USB stack can be find on the official Linux USB Project web page 
http://www.linux-usb.org. 


User’s Manual 140 Revision 1.0, 2006-11-14 

Programmer’s Reference 



INCA-IP2 

IP-Phone Solution, Linux® BSP Release 2.0 


CONFIDENTIAL 


Bluetooth Support 


12 Bluetooth Support 


The Bluetooth wireless technology is a specification for a small-form factor, low-cost radio solution that provides 
links between mobile computers, mobile phones and other portable handheld devices. The specification is 
developed, published and promoted by the Bluetooth Special Interest Group (SIG; http://www.bluetooth.com). 
BlueZ (http://www.bluez.org) is an implementation of the Bluetooth™ wireless standards specifications for Linux. 
It provides support for the core Bluetooth layers and protocols. The supported protocols and profiles are listed 
below: 

Protocols 

• Host Controller Interface (HCI) 

• Logical Link Control and Adaptation Layer Protocol (L2CAP) 

• RFCOMM Protocol 

• Bluetooth Network Encapsulation Protocol (BNEP) 

Profiles 

• Human Interface Device 

• Hardcopy Cable Replacement 

• Advanced Audio Distribution 

The BlueZ code is licensed under the GNU General Public License (GPL) and is incorporated in the INCA-IP2 
Linux BSP. Information about using BlueZ can be find on the official BlueZ web page 
http://www.bl uez.org/documentation . html . 
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13 Multiplexer Support 


To be able to include some features the INCA-IP2 needs to use a multiplexer for several pins. These pins include 
LEDs, keypad, ASC etc. Since each board is different it is necessary to adapt the multiplexer settings for each 
specific board. This is done during kernel configuration in the machine setup section, where a function can be 
selected for each pin. This selection determines which hardware blocks are available, which will influence the 
behaviour of some drivers like the LED part of the TSF driver. If an application needs to know the current settings 
of the multiplexer it can use several functions which are provided by the multiplex driver to query this information. 

13.1 Function Reference 

This chapter contains the Function reference. 


Table 19 FunctionOverview 


Name 

Description 

ifxmuxpwmlpins 

Availability of PWM1 . 

ifx_mux_pwm2_pins 

Availability of PWM2. 

ifx_mux_ssc_pins 

Availability of SSC Ports. 

ifx_mux_asc1_pins 

Availability of ASCI. 

ifxmuxascOpins 

Availability of ASCO. 

ifx_m ux_u s b_p i ns 

Availability of USB. 

ifx_mux_clock_out_pins 

Availability of Clock Output. 

ifxmuxrtcclockpins 

Availability of RTC clock input. 

ifxmuxledpins 

Number of LEDs. 

ifx_mux_key_pins 

Number of Keypad pins. 

ifxmuxexinpins 

Number of EXIN pins. 

ifxmuxebucspins 

Number of EBU chip select pins. 

ifx_mux_ebuaddr_pins 

Number of EBU address pins. 

ifx_mux_gp_pins 

Number of GP pins. 


13.1.1 ifxmuxpwmlpins 


Description 

Availability of PWM1. 

This functions reports whether support for PWM1 is enabled in the multiplexer settings. 

Prototype 

u32 ifx_mux_pwml_pins ( 


void ) ; 


Parameters 


Data Type 


Name 


Description 


void 
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Return Values 


'Infineon 


Data Type 

Description 

u32 

1 PWM1 is available 


0 PWM1 is not available. 


13.1.2 ifx _mux_pwm2_pins 

Description 

Availability of PWM2. 

This functions reports whether support for PWM2 is enabled in the multiplexer settings. 

Prototype 

u32 ifx_mux_pwm2_pins ( 
void ) ; 

Parameters 


Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

u32 

1 PWM2 is available 


0 PWM2 is not available. 


13.1.3 ifx _mux_ssc_pins 

Description 

Availability of SSC Ports. 

This functions reports which SSC ports are available. 

Prototype 

u32 ifx_mux_ssc_pins ( 
void ) ; 

Parameters 


Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

u32 

mux_ssc bitfield of available SSC ports 
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13.1.4 ifx_mux_asc1_pins 

Description 

Availability of ASCI. 

This functions reports whether support for ASCI is enabled in the multiplexer settings. 

Prototype 

u32 ifx_mux_ascl_pins ( 
void ) ; 

Parameters 


'Infineon 


Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

u32 

1 ASCI is available 


0 ASCI is not available. 


13.1.5 ifx mux ascO pins 

Description 

Availability of ASCO. 

This functions reports whether support for ASCO is enabled in the multiplexer settings. 

Prototype 

u32 ifx_mux_ascO_pins ( 
void ) ; 

Parameters 


Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

u32 

1 ASCO is available 


0 ASCO is not available. 


13.1.6 ifx _mux_usb_pins 

Description 

Availability of USB. 
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This functions reports whether support for USB is enabled in the multiplexer settings. 

Prototype 

u32 ifx_mux_usb_pins ( 
void ) ; 

Parameters 


'Infineon 


Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

u32 

1 USB is available 


0 USB is not available. 


13.1.7 ifx _mux_clock_out_pins 

Description 

Availability of Clock Output. 

This functions reports which alternate clock pins are available. 

Prototype 

u32 ifx_mux_clock_out_pins ( 
void ) ; 

Parameters 


Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

u32 

mux_altclock bitfield of available alternate clock pins 


13.1.8 ifx _mux_rtc_clock_pins 

Description 

Availability of RTC clock input. 

This functions reports whether support for the 32kHz RTC input clock (CLK32) is enabled in the multiplexer 
settings. 

Prototype 

u32 ifx_mux_rtc_clock_pins ( 
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void ) ; 

Parameters 


Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

u32 

1 CLK32 is available 


0 CLK32 is not available. 


13.1.9 ifx mux led pins 

Description 

Number of LEDs. 

This functions reports the number of available LEDs 

Prototype 

u32 ifx_mux_led_pins ( 
void ) ; 

Parameters 


Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

u32 

num Number of available LEDs 


13.1.10 ifx_mux_key_pins 


Description 

Number of Keypad pins. 

This functions reports the number of available keypad pins 

Prototype 

u32 ifx_mux_key_pins ( 
void ) ; 
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Parameters 



Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

u32 

num Number of available keypad pins 


13.1.11 ifx_mux_exin_pins 

Description 

Number of EXIN pins. 

This functions returns the bitfield of available external interrupt pins 

Prototype 

u32 ifx_mux_exin_pins ( 
void ) ; 

Parameters 


Data Type 

Name 

Description 

void 




Return Values 


Data Type 

Description 

u32 

mux_exin bitfield of available external interrupts pins 


13.1.12 ifx _mux_ebucs_pins 

Description 

Number of EBU chip select pins. 

This functions returns the bitfield of available EBU chip select pins 

Prototype 

u32 ifx_mux_ebucs_pins ( 
void ) ; 

Parameters 


Data Type 

Name 

Description 

void 
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Return Values 


'Infineon 


Data Type 

Description 

u32 

mux_ebucs bitfield of available EBU chip select pins 


13.1.13 ifx _mux_ebuaddr_pins 

Description 

Number of EBU address pins. 


This functions returns the bitfield of available EBU address pins 

Prototype 

u32 ifx_mux_ebuaddr_pins ( 
void ) ; 

Parameters 


Data Type 


Name 

Description 

void 




Return Values 




Data Type 

Description 


u32 

muxj 

ebuaddr bitfield of available EBU address pins 

13.1.14 ifx mux gp pins 


Description 

Number of GP pins. 

This functions returns the bitfield of available general purpose pins 

Prototype 

u 3 2 if x_mux_gp_p ins 
void ) ; 

( 



Parameters 




Data Type 


Name 

Description 

void 




Return Values 




Data Type 

Description 


u32 

mux_gp bitfield of available general purpose pins 


User’s Manual 
Programmer’s Reference 


148 


Revision 1.0, 2006-11-14 



INCA-IP2 

IP-Phone Solution, Linux® BSP Release 2.0 


CONFIDENTIAL 


Parallel Port Support 


14 Parallel Port Support 

The INCA-IP2 supports up to 28 general purpose pins depending on the multiplexer settings. For each pin the 
input/output settings can be changed individually. 

14.1 Usage 

Before it is possible to change the settings for a pin it needs to be reserved with the ifx_port_reserve function. To 
give some protection from unintended changes by other functions each function that wants to change a pin needs 
to get a unique module ID, which will identify the owner of a currently reserved pin. 

If the user interface is used the IOCTL call will automatically reserve and release the specific pin. 

14.2 Function Reference 

This chapter contains the Function reference. 


Table 20 FunctionOverview 


Name 

Description 

ifx_port_ssc_cs_set 

Set direction bit for chip select. 

ifxportsscmasterset 

Set direction bit for SSC pins. 

ifx_port_reserve_pin 

Reserve port pin for usage. 

ifx_port_free_pin 

Free port pin. 

ifxportseto pe n_d ra i n 

Enable Open Drain for given pin. 

ifx_port_clear_open_drain 

Disable Open Drain for given pin. 

ifx_port_set_puden 

Set PUDEN bit for given pin. 

ifx_port_clear_puden 

Disable PUDEN bit for given pin. 

ifxportsetstoff 

Enable Schmitt Trigger for given pin. 

ifx_port_clear_stoff 

Disable Schmitt Trigger for given pin. 

ifx_port_set_dir_out 

Set direction to output for given pin. 

ifx_port_set_dir_in 

Set direction to input for given pin. 

ifx_port_set_output 

Set output bit for given pin. 

ifx_port_clear_output 

Clear output bit for given pin. 

ifxportgetinput 

Get input bit for given pin. 

ifxportopen 

Open port device. 

ifx_port_release 

Release port device. 

ifxportioctl 

Port driver IOCTL handler. 


14.2.1 ifx_port_ssc_cs_set 

Description 

Set direction bit for chip select. 

This function sets the direction bit for the SSC chip select depending on the master/slave setting. 

Prototype 

int ifx_port_ssc_cs_set ( 
int ssc_port, 
int cs. 
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int master ) ; 

Parameters 


Data Type 

Name 

Description 

int 

ssc_port 

SSC Port number (0 or 1 ) 

int 

cs 

Chip select (0 or 1) 

int 

master 

Master/Slave select (1=master, 0=slave) 


Return Values 


Data Type 

Description 

int 

-EINVAL Invalid ssc_port, cs or master value provided. 

OOK 


14.2.2 ifx_port_ssc_master_set 


Description 

Set direction bit for SSC pins. 

This function sets the direction bits for the SSC clock and data pins depending on the master/slave setting. 

Prototype 

int ifx_port_ssc_master_set ( 
int ssc_port, 
int master ) ; 

Parameters 


Data Type 

Name 

Description 

int 

ssc_port 

SSC Port number (0 or 1 ) 

int 

master 

Master/Slave select (1=master, 0=slave) 


Return Values 


Data Type 

Description 

int 

-EINVAL Invalid ssc_port or master value provided. 

OOK 


14.2.3 ifx_port_reserve_pin 


Description 

Reserve port pin for usage. 

This function reserves a given pin for usage by the given module. 

Prototype 

int ifx_port_reserve_pin ( 
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int port, 
int pin, 

int module_id ) ; 

Parameters 


Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be reserved 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin allready used. 


-EINVAL Invalid port or pin provided. 


0 OK, pin reserved 


14.2.4 ifx_port_free_pin 

Description 

Free port pin. 

This functions frees a port pin and thus clears the entry in the usage map. 

Prototype 

int ifx_port_free_pin ( 
int port, 
int pin, 

int module_id ) ; 

Parameters 


Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be released 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

0 OK, pin freed 
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14.2.5 ifx_port_set_open_drain 

Description 

Enable Open Drain for given pin. 

This function sets Open Drain mode for the given pin. 

Prototype 

int ifx_port_set_open_drain ( 
int port, 
int pin, 

int module_id ) ; 

Parameters 


'Infineon 


Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

-ERESTARTSYS Another instance is using the driver. 

0 OK, pin freed 


14.2.6 ifx_port_clear_open_drain 

Description 

Disable Open Drain for given pin. 

This function clears Open Drain mode for the given pin. 

Prototype 

int ifx_port_clear_open_drain ( 
int port, 
int pin, 

int module_id ) ; 

Parameters 


Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 
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Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

-ERESTARTSYS Another instance is using the driver. 

0 OK, pin freed 


14.2.7 ifx_port_set_puden 

Description 

Set PUDEN bit for given pin. 

This function sets the PUDEN bit for the given pin. 

Prototype 

int ifx_port_set_puden ( 
int port, 
int pin, 

int module_id ) ; 

Parameters 


Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

-ERESTARTSYS Another instance is using the driver. 

0 OK, pin freed 


14.2.8 ifx_port_clear_puden 

Description 

Disable PUDEN bit for given pin. 

This function clears the PUDEN bit for the given pin. 

Prototype 

int ifx_port_clear_puden ( 
int port, 
int pin, 

int module_id ) ; 
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Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

-ERESTARTSYS Another instance is using the driver. 

0 OK, pin freed 


14.2.9 ifx_port_set_stoff 

Description 

Enable Schmitt Trigger for given pin. 

This function enables the Schmitt Trigger for the given pin. 

Prototype 

int ifx_port_set_stof f ( 
int port, 
int pin, 

int module_id ) ; 

Parameters 


Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

-ERESTARTSYS Another instance is using the driver. 

0 OK, pin freed 


14.2.10 ifxportclearstoff 

Description 

Disable Schmitt Trigger for given pin. 
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This function disables the Schmitt Trigger for the given pin. 

Prototype 

int ifx_port_clear_stof f ( 
int port, 
int pin, 

int module_id ) ; 

Parameters 


'Infineon 


Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

-ERESTARTSYS Another instance is using the driver. 

0 OK, pin freed 


14.2.11 ifx_port_set_dir_out 

Description 

Set direction to output for given pin. 

This function sets the direction for the given pin to output. 

Prototype 

int ifx_port_set_dir_out ( 
int port, 
int pin, 

int module_id ) ; 

Parameters 


Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 
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Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

-ERESTARTSYS Another instance is using the driver. 

0 OK, pin freed 


14.2.12 ifx_port_set_dir_in 

Description 

Set direction to input for given pin. 

This function sets the direction for the given pin to input. 

Prototype 

int ifx_port_set_dir_in ( 
int port, 
int pin, 

int module_id ) ; 

Parameters 


Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

-ERESTARTSYS Another instance is using the driver. 

0 OK, pin freed 


14.2.13 ifx_port_set_output 

Description 

Set output bit for given pin. 

This function sets the output bit to 1 for the given pin. 

Prototype 

int ifx_port_set_output ( 
int port, 
int pin, 

int module_id ) ; 
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Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

-ERESTARTSYS Another instance is using the driver. 

0 OK, pin freed 


14.2.14 ifx_port_clear_output 

Description 

Clear output bit for given pin. 

This function clears the output bit for the given pin. 

Prototype 

int ifx_port_clear_output ( 
int port, 
int pin, 

int module_id ) ; 

Parameters 


Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

-ERESTARTSYS Another instance is using the driver. 

0 OK, pin freed 


14.2.15 ifx_port_get_input 

Description 

Get input bit for given pin. 
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This function gets the value of the given pin. 

Prototype 

int ifx_port_get_input ( 
int port, 
int pin, 

int module_id ) ; 

Parameters 
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Data Type 

Name 

Description 

int 

port 

Port number 

int 

pin 

Pin to be used 

int 

modulejd 

Module ID to identify the owner of a pin 


Return Values 


Data Type 

Description 

int 

-EBUSY Pin used by another module than the given ID. 

-EINVAL Invalid port or pin provided. 

0 OK, pin freed 


14.2.16 ifx_port_open 


Description 

Open port device. 

This function is called when the port device is opend and it will increase the usage counter. 

Prototype 

int ifx_port_open ( 

struct inode * inode, 
struct file * filep ) ; 

Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device 

struct file * 

filep 

File structure of device 


Return Values 


Data Type 

Description 

int 

OK OK, device opened 

User’s Manual 


158 

Revision 1.0, 2006-11-14 

Programmer’s Reference 





INCA-IP2 

IP-Phone Solution, Linux® BSP Release 2.0 

CONFIDENTIAL Parallel Port Support 

14.2.17 ifx_port_release 

Description 

Release port device. 

This function is called when the port device is closed and it will decrease the usage counter. 

Prototype 

int ifx_port_release ( 

struct inode * inode, 
struct file * filelp ) ; 

Parameters 
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Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device 

struct file * 

filelp 

File structure of device 


Return Values 


Data Type 

Description 

int 

0 OK, device opened 


14.2.18 ifx_port_ioctl 

Description 

Port driver IOCTL handler. 

The following lOCTLs are supported for the port device. (All command use the arg parameter, which is an struct 

defining port, pin and value to use.) 

• IFX_PORT_IOCPUDEN 

• IFXPORTIOCDIR 

• IFX_PORT_IOCOUTPUT 

• IFXPORTIOCINPUT 

• IFXPORTIOCOD 

• IFX_PORT_IOCSTOFF 

Prototype 

int ifx_port_ioctl ( 

struct inode * inode, 
struct file * filp, 
unsigned int cmd, 
unsigned long arg ) j 

Parameters 


Data Type 

Name 

Description 

struct inode * 

inode 

Inode of device 

struct file * 

filp 

File structure of device 
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Data Type 

Name 

Description 

unsigned int 

cmd 

IOCTL command 

unsigned long 

arg 

Argument for some IOCTL commands 


Return Values 


Data Type 

Description 

int 

OOK 

-EINVAL An invalid command was specified 
-EFAULT An error occured on accessing the argument 
-ERESTARTSYS The port driver is currently busy. 


14.3 IOCTL Reference 

This chapter contains the IOCTL reference. 


Table 21 DefineOverview 


Name 

Description 

IFXPORTIOCOD 

Sets/clears the open drain enable bit. 

IFXPORTJOCPUDEN 

Sets/clears the pull up/down enable bit. 

IFX PORT IOCSTOFF 

Sets/clears the schmitt trigger enable bit. 

IFX PORT IOCDIR 

Sets/clears the direction selection bit. 

IFX PORT IOCOUTPUT 

Sets/clears the output value bit. 

IFX PORT IOCINPUT 

Reads the input value bit and stores it in arg->value. 


14.3.1 IFXPORTIOCOD 


Prototype 

#def ine IFX_PORT_IOCOD _IOW ( IFX_PORT_IOC_MAGIC , 0 , struct ifx_port_ioctl_parm) 

Parameters 


Data Type 

Name 

Description 

IFX_PORT_IOCOD 

J O W( 1 FX_PORT_l OC_MAG 1 
C,0, struct ifx_portJoctl_parm) 

Sets/clears the open drain enable bit. 


14.3.2 IFXPORTJOCPUDEN 
Prototype 

ttdefine IFX_PORT_IOCPUDEN _IOW(IFX_PORT_IOC_MAGIC, 2 , struct ifx_port_ioctl_parm) 

Parameters 


Data Type 

Name 

Description 

IFX_PORTJOCPUDEN 

J OW( 1 FX_PORT_IOC_MAG 1 
C, 2, struct ifx_portJoctl_parm) 

Sets/clears the pull up/down enable bit. 
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14.3.3 IFXPORTJOCSTOFF 

Prototype 

ttdefine IFX_PORT_IOCSTOFF _IOW ( IFX_PORT_IOC_MAGIC , 3 , struct ifx_port_ioctl_parm) 

Parameters 


'Infineon 


Data Type 

Name 

Description 

IFX_PORT_IOCSTOFF 

_l OW( 1 FX_PORT_l OC_M AG 1 
C, 3, struct ifx_port_ioctl_parm) 

Sets/clears the schmitt trigger enable bit. 


14.3.4 IFXPORTJOCDIR 
Prototype 

ttdefine IFX_PORT_IOCDIR _IOW ( IFX_PORT_IOC_MAGIC , 4 , struct ifx_port_ioctl_parm) 

Parameters 


Data Type 

Name 

Description 

IFXPORTIOCDIR 

_l OW( 1 FX_PORT_l OC_M AG 1 
C, 4, struct ifx_port_ioctl_parm) 

Sets/clears the direction selection bit. 


14.3.5 IFXPORTIOCOUTPUT 
Prototype 

#def ine IFX_PORT_IOCOUTPUT _IOW ( IFX_PORT_IOC_MAGIC , 5 , struct ifx_port_ioctl_parm) 

Parameters 


Data Type 

Name 

Description 

IFX_PORT_IOCOUTPUT 

_l 0 W( 1 FX_PO RT_IOC_MAG 1 
C, 5, struct ifx_port_ioctl_parm) 

Sets/clears the output value bit. 


14.3.6 IFXPORTJOCINPUT 
Prototype 

#def ine IFX_PORT_IOCINPUT _IOWR ( IFX_PORT_IOC_MAGIC , 6 , struct ifx_port_ioctl_parm) 

Parameters 


Data Type 

Name 

Description 

IFX_PORT_IOCINPUT 

_l 0 WR( 1 FX_PO RT_I OC_M A 
GIC, 6, struct 
ifx_port_ioctl_pa rm ) 

Reads the input value bit and stores it in arg- 
>value. 
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15 TAPIV3.X 

With the introduction of version 3.0, TAPI is able to support the VoIP function of multiple Infineon devices/families, 
including the latest IP-Phone device, VoIP processor and residential gateway SoC. 

Infineon TAPI is implemented in two layers: TAPI High Level (HL), abstracting the features up to a none device 
specific level, and TAPI Low Level (LL) implementing the device specific part (for example HW/FW access). 

TAPI is able of supporting multiple Infineon devices belonging to different families. The most noticeable 
architectural change in the TAPI V3.x is delivering TAPI HL as a separate driver, the TAPI LL is implemented in a 
separate binary per supported device. 

Both control and data paths use TAPI interfaces. Figure 4 provides an overview of the TAPI architecture, in the 
particular configuration two different Infineon devices are controlled by TAPI. As shown in the figure, three device 
drivers must be loaded. To be noted that some Infineon device drivers include device specific commands (such 
as device initialization) that, although not part of TAPI, are passed through the TAPI OS interface. A classification 
of TAPI and non-TAPI commands is done by the ioctl dispatcher (see Figure 4). 


'Infineon 



Figure 4 TAPI V3.x Architecture 


15.1 VMMC Interfaces Reference 

15.1.1 FIO_GET_VERS 

Description 

Read relevant version information. 
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Prototype 

void ioctl ( 

int fd, 

FIO_GET_VERS , 
int param ) ; 

Parameters 
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Data Type 

Name 

Description 

int 

fd 

File descriptor 

int 

FIOJ3ETVERS 

I/O control identifier for this operation 

VMMCJOVERSION* 

param 

Pointer to the struct containing the version 
information. 


15.1.2 VMMCJOJNIT 

Description 

Structure used for device initialization 

Prototype 

typedef struct 
{ 

unsigned char * pPRAMfw; 
unsigned long pram_size; 
unsigned char * pBBDbuf ; 
unsigned long bbd_size; 
unsigned long nFlags; 
unsigned short nPhiCrc; 
unsigned short nDcCrc; 
unsigned short nAcCrc; 

} VMMC_IO_INIT_t ; 


Data Type 

Name 

Description 

unsigned char * 

pPRAMfw 

Firmware PRAM pointer or NULL if not needed. 

unsigned long 

pram_size 

Size of PRAM firmware in bytes 

unsigned char * 

pBBDbuf 

Pointer to block based download format data 

unsigned long 

bbd_size 

Size of block based download buffer 

unsigned long 

nFlags 

Flags for initialization. Reserved. 


15.1.3 VMMCJOVERSION 

Description 

Version lo structure. 
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Prototype 

typedef struct 
{ 

unsigned char nType; 
unsigned char nChannel; 
unsigned short nChip; 
unsigned long nTapiVers; 
unsigned long nDrvVers; 
unsigned short nEdspVers ; 
unsigned short nEdspIntern; 
unsigned short nDCCtrlVers ; 
} VMMC_IO_VERSION_t; 


Parameters 
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Data Type 

Name 

Description 

unsigned char 

nType 

Chip type 

unsigned char 

nChannel 

Number of supported analog channels 

unsigned short 

nChip 


unsigned long 

nTapiVers 

Included TAPI version 

unsigned long 

nDrvVers 

Driver version 

unsigned short 

nEdspVers 

EDSP major version. 

unsigned short 

nEdspIntern 

EDSP version step. 

unsigned short 

nDCCtrlVers 

DC Ctrl version. 
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